wekan.html 996 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255525652575258525952605261526252635264526552665267526852695270527152725273527452755276527752785279528052815282528352845285528652875288528952905291529252935294529552965297529852995300530153025303530453055306530753085309531053115312531353145315531653175318531953205321532253235324532553265327532853295330533153325333533453355336533753385339534053415342534353445345534653475348534953505351535253535354535553565357535853595360536153625363536453655366536753685369537053715372537353745375537653775378537953805381538253835384538553865387538853895390539153925393539453955396539753985399540054015402540354045405540654075408540954105411541254135414541554165417541854195420542154225423542454255426542754285429543054315432543354345435543654375438543954405441544254435444544554465447544854495450545154525453545454555456545754585459546054615462546354645465546654675468546954705471547254735474547554765477547854795480548154825483548454855486548754885489549054915492549354945495549654975498549955005501550255035504550555065507550855095510551155125513551455155516551755185519552055215522552355245525552655275528552955305531553255335534553555365537553855395540554155425543554455455546554755485549555055515552555355545555555655575558555955605561556255635564556555665567556855695570557155725573557455755576557755785579558055815582558355845585558655875588558955905591559255935594559555965597559855995600560156025603560456055606560756085609561056115612561356145615561656175618561956205621562256235624562556265627562856295630563156325633563456355636563756385639564056415642564356445645564656475648564956505651565256535654565556565657565856595660566156625663566456655666566756685669567056715672567356745675567656775678567956805681568256835684568556865687568856895690569156925693569456955696569756985699570057015702570357045705570657075708570957105711571257135714571557165717571857195720572157225723572457255726572757285729573057315732573357345735573657375738573957405741574257435744574557465747574857495750575157525753575457555756575757585759576057615762576357645765576657675768576957705771577257735774577557765777577857795780578157825783578457855786578757885789579057915792579357945795579657975798579958005801580258035804580558065807580858095810581158125813581458155816581758185819582058215822582358245825582658275828582958305831583258335834583558365837583858395840584158425843584458455846584758485849585058515852585358545855585658575858585958605861586258635864586558665867586858695870587158725873587458755876587758785879588058815882588358845885588658875888588958905891589258935894589558965897589858995900590159025903590459055906590759085909591059115912591359145915591659175918591959205921592259235924592559265927592859295930593159325933593459355936593759385939594059415942594359445945594659475948594959505951595259535954595559565957595859595960596159625963596459655966596759685969597059715972597359745975597659775978597959805981598259835984598559865987598859895990599159925993599459955996599759985999600060016002600360046005600660076008600960106011601260136014601560166017601860196020602160226023602460256026602760286029603060316032603360346035603660376038603960406041604260436044604560466047604860496050605160526053605460556056605760586059606060616062606360646065606660676068606960706071607260736074607560766077607860796080608160826083608460856086608760886089609060916092609360946095609660976098609961006101610261036104610561066107610861096110611161126113611461156116611761186119612061216122612361246125612661276128612961306131613261336134613561366137613861396140614161426143614461456146614761486149615061516152615361546155615661576158615961606161616261636164616561666167616861696170617161726173617461756176617761786179618061816182618361846185618661876188618961906191619261936194619561966197619861996200620162026203620462056206620762086209621062116212621362146215621662176218621962206221622262236224622562266227622862296230623162326233623462356236623762386239624062416242624362446245624662476248624962506251625262536254625562566257625862596260626162626263626462656266626762686269627062716272627362746275627662776278627962806281628262836284628562866287628862896290629162926293629462956296629762986299630063016302630363046305630663076308630963106311631263136314631563166317631863196320632163226323632463256326632763286329633063316332633363346335633663376338633963406341634263436344634563466347634863496350635163526353635463556356635763586359636063616362636363646365636663676368636963706371637263736374637563766377637863796380638163826383638463856386638763886389639063916392639363946395639663976398639964006401640264036404640564066407640864096410641164126413641464156416641764186419642064216422642364246425642664276428642964306431643264336434643564366437643864396440644164426443644464456446644764486449645064516452645364546455645664576458645964606461646264636464646564666467646864696470647164726473647464756476647764786479648064816482648364846485648664876488648964906491649264936494649564966497649864996500650165026503650465056506650765086509651065116512651365146515651665176518651965206521652265236524652565266527652865296530653165326533653465356536653765386539654065416542654365446545654665476548654965506551655265536554655565566557655865596560656165626563656465656566656765686569657065716572657365746575657665776578657965806581658265836584658565866587658865896590659165926593659465956596659765986599660066016602660366046605660666076608660966106611661266136614661566166617661866196620662166226623662466256626662766286629663066316632663366346635663666376638663966406641664266436644664566466647664866496650665166526653665466556656665766586659666066616662666366646665666666676668666966706671667266736674667566766677667866796680668166826683668466856686668766886689669066916692669366946695669666976698669967006701670267036704670567066707670867096710671167126713671467156716671767186719672067216722672367246725672667276728672967306731673267336734673567366737673867396740674167426743674467456746674767486749675067516752675367546755675667576758675967606761676267636764676567666767676867696770677167726773677467756776677767786779678067816782678367846785678667876788678967906791679267936794679567966797679867996800680168026803680468056806680768086809681068116812681368146815681668176818681968206821682268236824682568266827682868296830683168326833683468356836683768386839684068416842684368446845684668476848684968506851685268536854685568566857685868596860686168626863686468656866686768686869687068716872687368746875687668776878687968806881688268836884688568866887688868896890689168926893689468956896689768986899690069016902690369046905690669076908690969106911691269136914691569166917691869196920692169226923692469256926692769286929693069316932693369346935693669376938693969406941694269436944694569466947694869496950695169526953695469556956695769586959696069616962696369646965696669676968696969706971697269736974697569766977697869796980698169826983698469856986698769886989699069916992699369946995699669976998699970007001700270037004700570067007700870097010701170127013701470157016701770187019702070217022702370247025702670277028702970307031703270337034703570367037703870397040704170427043704470457046704770487049705070517052705370547055705670577058705970607061706270637064706570667067706870697070707170727073707470757076707770787079708070817082708370847085708670877088708970907091709270937094709570967097709870997100710171027103710471057106710771087109711071117112711371147115711671177118711971207121712271237124712571267127712871297130713171327133713471357136713771387139714071417142714371447145714671477148714971507151715271537154715571567157715871597160716171627163716471657166716771687169717071717172717371747175717671777178717971807181718271837184718571867187718871897190719171927193719471957196719771987199720072017202720372047205720672077208720972107211721272137214721572167217721872197220722172227223722472257226722772287229723072317232723372347235723672377238723972407241724272437244724572467247724872497250725172527253725472557256725772587259726072617262726372647265726672677268726972707271727272737274727572767277727872797280728172827283728472857286728772887289729072917292729372947295729672977298729973007301730273037304730573067307730873097310731173127313731473157316731773187319732073217322732373247325732673277328732973307331733273337334733573367337733873397340734173427343734473457346734773487349735073517352735373547355735673577358735973607361736273637364736573667367736873697370737173727373737473757376737773787379738073817382738373847385738673877388738973907391739273937394739573967397739873997400740174027403740474057406740774087409741074117412741374147415741674177418741974207421742274237424742574267427742874297430743174327433743474357436743774387439744074417442744374447445744674477448744974507451745274537454745574567457745874597460746174627463746474657466746774687469747074717472747374747475747674777478747974807481748274837484748574867487748874897490749174927493749474957496749774987499750075017502750375047505750675077508750975107511751275137514751575167517751875197520752175227523752475257526752775287529753075317532753375347535753675377538753975407541754275437544754575467547754875497550755175527553755475557556755775587559756075617562756375647565756675677568756975707571757275737574757575767577757875797580758175827583758475857586758775887589759075917592759375947595759675977598759976007601760276037604760576067607760876097610761176127613761476157616761776187619762076217622762376247625762676277628762976307631763276337634763576367637763876397640764176427643764476457646764776487649765076517652765376547655765676577658765976607661766276637664766576667667766876697670767176727673767476757676767776787679768076817682768376847685768676877688768976907691769276937694769576967697769876997700770177027703770477057706770777087709771077117712771377147715771677177718771977207721772277237724772577267727772877297730773177327733773477357736773777387739774077417742774377447745774677477748774977507751775277537754775577567757775877597760776177627763776477657766776777687769777077717772777377747775777677777778777977807781778277837784778577867787778877897790779177927793779477957796779777987799780078017802780378047805780678077808780978107811781278137814781578167817781878197820782178227823782478257826782778287829783078317832783378347835783678377838783978407841784278437844784578467847784878497850785178527853785478557856785778587859786078617862786378647865786678677868786978707871787278737874787578767877787878797880788178827883788478857886788778887889789078917892789378947895789678977898789979007901790279037904790579067907790879097910791179127913791479157916791779187919792079217922792379247925792679277928792979307931793279337934793579367937793879397940794179427943794479457946794779487949795079517952795379547955795679577958795979607961796279637964796579667967796879697970797179727973797479757976797779787979798079817982798379847985798679877988798979907991799279937994799579967997799879998000800180028003800480058006800780088009801080118012801380148015801680178018801980208021802280238024802580268027802880298030803180328033803480358036803780388039804080418042804380448045804680478048804980508051805280538054805580568057805880598060806180628063806480658066806780688069807080718072807380748075807680778078807980808081808280838084808580868087808880898090809180928093809480958096809780988099810081018102810381048105810681078108810981108111811281138114811581168117811881198120812181228123812481258126812781288129813081318132813381348135813681378138813981408141814281438144814581468147814881498150815181528153815481558156815781588159816081618162816381648165816681678168816981708171817281738174817581768177817881798180818181828183818481858186818781888189819081918192819381948195819681978198819982008201820282038204820582068207820882098210821182128213821482158216821782188219822082218222822382248225822682278228822982308231823282338234823582368237823882398240824182428243824482458246824782488249825082518252825382548255825682578258825982608261826282638264826582668267826882698270827182728273827482758276827782788279828082818282828382848285828682878288828982908291829282938294829582968297829882998300830183028303830483058306830783088309831083118312831383148315831683178318831983208321832283238324832583268327832883298330833183328333833483358336833783388339834083418342834383448345834683478348834983508351835283538354835583568357835883598360836183628363836483658366836783688369837083718372837383748375837683778378837983808381838283838384838583868387838883898390839183928393839483958396839783988399840084018402840384048405840684078408840984108411841284138414841584168417841884198420842184228423842484258426842784288429843084318432843384348435843684378438843984408441844284438444844584468447844884498450845184528453845484558456845784588459846084618462846384648465846684678468846984708471847284738474847584768477847884798480848184828483848484858486848784888489849084918492849384948495849684978498849985008501850285038504850585068507850885098510851185128513851485158516851785188519852085218522852385248525852685278528852985308531853285338534853585368537853885398540854185428543854485458546854785488549855085518552855385548555855685578558855985608561856285638564856585668567856885698570857185728573857485758576857785788579858085818582858385848585858685878588858985908591859285938594859585968597859885998600860186028603860486058606860786088609861086118612861386148615861686178618861986208621862286238624862586268627862886298630863186328633863486358636863786388639864086418642864386448645864686478648864986508651865286538654865586568657865886598660866186628663866486658666866786688669867086718672867386748675867686778678867986808681868286838684868586868687868886898690869186928693869486958696869786988699870087018702870387048705870687078708870987108711871287138714871587168717871887198720872187228723872487258726872787288729873087318732873387348735873687378738873987408741874287438744874587468747874887498750875187528753875487558756875787588759876087618762876387648765876687678768876987708771877287738774877587768777877887798780878187828783878487858786878787888789879087918792879387948795879687978798879988008801880288038804880588068807880888098810881188128813881488158816881788188819882088218822882388248825882688278828882988308831883288338834883588368837883888398840884188428843884488458846884788488849885088518852885388548855885688578858885988608861886288638864886588668867886888698870887188728873887488758876887788788879888088818882888388848885888688878888888988908891889288938894889588968897889888998900890189028903890489058906890789088909891089118912891389148915891689178918891989208921892289238924892589268927892889298930893189328933893489358936893789388939894089418942894389448945894689478948894989508951895289538954895589568957895889598960896189628963896489658966896789688969897089718972897389748975897689778978897989808981898289838984898589868987898889898990899189928993899489958996899789988999900090019002900390049005900690079008900990109011901290139014901590169017901890199020902190229023902490259026902790289029903090319032903390349035903690379038903990409041904290439044904590469047904890499050905190529053905490559056905790589059906090619062906390649065906690679068906990709071907290739074907590769077907890799080908190829083908490859086908790889089909090919092909390949095909690979098909991009101910291039104910591069107910891099110911191129113911491159116911791189119912091219122912391249125912691279128912991309131913291339134913591369137913891399140914191429143914491459146914791489149915091519152915391549155915691579158915991609161916291639164916591669167916891699170917191729173917491759176917791789179918091819182918391849185918691879188918991909191919291939194919591969197919891999200920192029203920492059206920792089209921092119212921392149215921692179218921992209221922292239224922592269227922892299230923192329233923492359236923792389239924092419242924392449245924692479248924992509251925292539254925592569257925892599260926192629263926492659266926792689269927092719272927392749275927692779278927992809281928292839284928592869287928892899290929192929293929492959296929792989299930093019302930393049305930693079308930993109311931293139314931593169317931893199320932193229323932493259326932793289329933093319332933393349335933693379338933993409341934293439344934593469347934893499350935193529353935493559356935793589359936093619362936393649365936693679368936993709371937293739374937593769377937893799380938193829383938493859386938793889389939093919392939393949395939693979398939994009401940294039404940594069407940894099410941194129413941494159416941794189419942094219422942394249425942694279428942994309431943294339434943594369437943894399440944194429443944494459446944794489449945094519452945394549455945694579458945994609461946294639464946594669467946894699470947194729473947494759476947794789479948094819482948394849485948694879488948994909491949294939494949594969497949894999500950195029503950495059506950795089509951095119512951395149515951695179518951995209521952295239524952595269527952895299530953195329533953495359536953795389539954095419542954395449545954695479548954995509551955295539554955595569557955895599560956195629563956495659566956795689569957095719572957395749575957695779578957995809581958295839584958595869587958895899590959195929593959495959596959795989599960096019602960396049605960696079608960996109611961296139614961596169617961896199620962196229623962496259626962796289629963096319632963396349635963696379638963996409641964296439644964596469647964896499650965196529653965496559656965796589659966096619662966396649665966696679668966996709671967296739674967596769677967896799680968196829683968496859686968796889689969096919692969396949695969696979698969997009701970297039704970597069707970897099710971197129713971497159716971797189719972097219722972397249725972697279728972997309731973297339734973597369737973897399740974197429743974497459746974797489749975097519752975397549755975697579758975997609761976297639764976597669767976897699770977197729773977497759776977797789779978097819782978397849785978697879788978997909791979297939794979597969797979897999800980198029803980498059806980798089809981098119812981398149815981698179818981998209821982298239824982598269827982898299830983198329833983498359836983798389839984098419842984398449845984698479848984998509851985298539854985598569857985898599860986198629863986498659866986798689869987098719872987398749875987698779878987998809881988298839884988598869887988898899890989198929893989498959896989798989899990099019902990399049905990699079908990999109911991299139914991599169917991899199920992199229923992499259926992799289929993099319932993399349935993699379938993999409941994299439944994599469947994899499950995199529953995499559956995799589959996099619962996399649965996699679968996999709971997299739974997599769977997899799980998199829983998499859986998799889989999099919992999399949995999699979998999910000100011000210003100041000510006100071000810009100101001110012100131001410015100161001710018100191002010021100221002310024100251002610027100281002910030100311003210033100341003510036100371003810039100401004110042100431004410045100461004710048100491005010051100521005310054100551005610057100581005910060100611006210063100641006510066100671006810069100701007110072100731007410075100761007710078100791008010081100821008310084100851008610087100881008910090100911009210093100941009510096100971009810099101001010110102101031010410105101061010710108101091011010111101121011310114101151011610117101181011910120101211012210123101241012510126101271012810129101301013110132101331013410135101361013710138101391014010141101421014310144101451014610147101481014910150101511015210153101541015510156101571015810159101601016110162101631016410165101661016710168101691017010171101721017310174101751017610177101781017910180101811018210183101841018510186101871018810189101901019110192101931019410195101961019710198101991020010201102021020310204102051020610207102081020910210102111021210213102141021510216102171021810219102201022110222102231022410225102261022710228102291023010231102321023310234102351023610237102381023910240102411024210243102441024510246102471024810249102501025110252102531025410255102561025710258102591026010261102621026310264102651026610267102681026910270102711027210273102741027510276102771027810279102801028110282102831028410285102861028710288102891029010291102921029310294102951029610297102981029910300103011030210303103041030510306103071030810309103101031110312103131031410315103161031710318103191032010321103221032310324103251032610327103281032910330103311033210333103341033510336103371033810339103401034110342103431034410345103461034710348103491035010351103521035310354103551035610357103581035910360103611036210363103641036510366103671036810369103701037110372103731037410375103761037710378103791038010381103821038310384103851038610387103881038910390103911039210393103941039510396103971039810399104001040110402104031040410405104061040710408104091041010411104121041310414104151041610417104181041910420104211042210423104241042510426104271042810429104301043110432104331043410435104361043710438104391044010441104421044310444104451044610447104481044910450104511045210453104541045510456104571045810459104601046110462104631046410465104661046710468104691047010471104721047310474104751047610477104781047910480104811048210483104841048510486104871048810489104901049110492104931049410495104961049710498104991050010501105021050310504105051050610507105081050910510105111051210513105141051510516105171051810519105201052110522105231052410525105261052710528105291053010531105321053310534105351053610537105381053910540105411054210543105441054510546105471054810549105501055110552105531055410555105561055710558105591056010561105621056310564105651056610567105681056910570105711057210573105741057510576105771057810579105801058110582105831058410585105861058710588105891059010591105921059310594105951059610597105981059910600106011060210603106041060510606106071060810609106101061110612106131061410615106161061710618106191062010621106221062310624106251062610627106281062910630106311063210633106341063510636106371063810639106401064110642106431064410645106461064710648106491065010651106521065310654106551065610657106581065910660106611066210663106641066510666106671066810669106701067110672106731067410675106761067710678106791068010681106821068310684106851068610687106881068910690106911069210693106941069510696106971069810699107001070110702107031070410705107061070710708107091071010711107121071310714107151071610717107181071910720107211072210723107241072510726107271072810729107301073110732107331073410735107361073710738107391074010741107421074310744107451074610747107481074910750107511075210753107541075510756107571075810759107601076110762107631076410765107661076710768107691077010771107721077310774107751077610777107781077910780107811078210783107841078510786107871078810789107901079110792107931079410795107961079710798107991080010801108021080310804108051080610807108081080910810108111081210813108141081510816108171081810819108201082110822108231082410825108261082710828108291083010831108321083310834108351083610837108381083910840108411084210843108441084510846108471084810849108501085110852108531085410855108561085710858108591086010861108621086310864108651086610867108681086910870108711087210873108741087510876108771087810879108801088110882108831088410885108861088710888108891089010891108921089310894108951089610897108981089910900109011090210903109041090510906109071090810909109101091110912109131091410915109161091710918109191092010921109221092310924109251092610927109281092910930109311093210933109341093510936109371093810939109401094110942109431094410945109461094710948109491095010951109521095310954109551095610957109581095910960109611096210963109641096510966109671096810969109701097110972109731097410975109761097710978109791098010981109821098310984109851098610987109881098910990109911099210993109941099510996109971099810999110001100111002110031100411005110061100711008110091101011011110121101311014110151101611017110181101911020110211102211023110241102511026110271102811029110301103111032110331103411035110361103711038110391104011041110421104311044110451104611047110481104911050110511105211053110541105511056110571105811059110601106111062110631106411065110661106711068110691107011071110721107311074110751107611077110781107911080110811108211083110841108511086110871108811089110901109111092110931109411095110961109711098110991110011101111021110311104111051110611107111081110911110111111111211113111141111511116111171111811119111201112111122111231112411125111261112711128111291113011131111321113311134111351113611137111381113911140111411114211143111441114511146111471114811149111501115111152111531115411155111561115711158111591116011161111621116311164111651116611167111681116911170111711117211173111741117511176111771117811179111801118111182111831118411185111861118711188111891119011191111921119311194111951119611197111981119911200112011120211203112041120511206112071120811209112101121111212112131121411215112161121711218112191122011221112221122311224112251122611227112281122911230112311123211233112341123511236112371123811239112401124111242112431124411245112461124711248112491125011251112521125311254112551125611257112581125911260112611126211263112641126511266112671126811269112701127111272112731127411275112761127711278112791128011281112821128311284112851128611287112881128911290112911129211293112941129511296112971129811299113001130111302113031130411305113061130711308113091131011311113121131311314113151131611317113181131911320113211132211323113241132511326113271132811329113301133111332113331133411335113361133711338113391134011341113421134311344113451134611347113481134911350113511135211353113541135511356113571135811359113601136111362113631136411365113661136711368113691137011371113721137311374113751137611377113781137911380113811138211383113841138511386113871138811389113901139111392113931139411395113961139711398113991140011401114021140311404114051140611407114081140911410114111141211413114141141511416114171141811419114201142111422114231142411425114261142711428114291143011431114321143311434114351143611437114381143911440114411144211443114441144511446114471144811449114501145111452114531145411455114561145711458114591146011461114621146311464114651146611467114681146911470114711147211473114741147511476114771147811479114801148111482114831148411485114861148711488114891149011491114921149311494114951149611497114981149911500115011150211503115041150511506115071150811509115101151111512115131151411515115161151711518115191152011521115221152311524115251152611527115281152911530115311153211533115341153511536115371153811539115401154111542115431154411545115461154711548115491155011551115521155311554115551155611557115581155911560115611156211563115641156511566115671156811569115701157111572115731157411575115761157711578115791158011581115821158311584115851158611587115881158911590115911159211593115941159511596115971159811599116001160111602116031160411605116061160711608116091161011611116121161311614116151161611617116181161911620116211162211623116241162511626116271162811629116301163111632116331163411635116361163711638116391164011641116421164311644116451164611647116481164911650116511165211653116541165511656116571165811659116601166111662116631166411665116661166711668116691167011671116721167311674116751167611677116781167911680116811168211683116841168511686116871168811689116901169111692116931169411695116961169711698116991170011701117021170311704117051170611707117081170911710117111171211713117141171511716117171171811719117201172111722117231172411725117261172711728117291173011731117321173311734117351173611737117381173911740117411174211743117441174511746117471174811749117501175111752117531175411755117561175711758117591176011761117621176311764117651176611767117681176911770117711177211773117741177511776117771177811779117801178111782117831178411785117861178711788117891179011791117921179311794117951179611797117981179911800118011180211803118041180511806118071180811809118101181111812118131181411815118161181711818118191182011821118221182311824118251182611827118281182911830118311183211833118341183511836118371183811839118401184111842118431184411845118461184711848118491185011851118521185311854118551185611857118581185911860118611186211863118641186511866118671186811869118701187111872118731187411875118761187711878118791188011881118821188311884118851188611887118881188911890118911189211893118941189511896118971189811899119001190111902119031190411905119061190711908119091191011911119121191311914119151191611917119181191911920119211192211923119241192511926119271192811929119301193111932119331193411935119361193711938119391194011941119421194311944119451194611947119481194911950119511195211953119541195511956119571195811959119601196111962119631196411965119661196711968119691197011971119721197311974119751197611977119781197911980119811198211983119841198511986119871198811989119901199111992119931199411995119961199711998119991200012001120021200312004120051200612007120081200912010120111201212013120141201512016120171201812019120201202112022120231202412025120261202712028120291203012031120321203312034120351203612037120381203912040120411204212043120441204512046120471204812049120501205112052120531205412055120561205712058120591206012061120621206312064120651206612067120681206912070120711207212073120741207512076120771207812079120801208112082120831208412085120861208712088120891209012091120921209312094120951209612097120981209912100121011210212103121041210512106121071210812109121101211112112121131211412115121161211712118121191212012121121221212312124121251212612127121281212912130121311213212133121341213512136121371213812139121401214112142121431214412145121461214712148121491215012151121521215312154121551215612157121581215912160121611216212163121641216512166121671216812169121701217112172121731217412175121761217712178121791218012181121821218312184121851218612187121881218912190121911219212193121941219512196121971219812199122001220112202122031220412205122061220712208122091221012211122121221312214122151221612217122181221912220122211222212223122241222512226122271222812229122301223112232122331223412235122361223712238122391224012241122421224312244122451224612247122481224912250122511225212253122541225512256122571225812259122601226112262122631226412265122661226712268122691227012271122721227312274122751227612277122781227912280122811228212283122841228512286122871228812289122901229112292122931229412295122961229712298122991230012301123021230312304123051230612307123081230912310123111231212313123141231512316123171231812319123201232112322123231232412325123261232712328123291233012331123321233312334123351233612337123381233912340123411234212343123441234512346123471234812349123501235112352123531235412355123561235712358123591236012361123621236312364123651236612367123681236912370123711237212373123741237512376123771237812379123801238112382123831238412385123861238712388123891239012391123921239312394123951239612397123981239912400124011240212403124041240512406124071240812409124101241112412124131241412415124161241712418124191242012421124221242312424124251242612427124281242912430124311243212433124341243512436124371243812439124401244112442124431244412445124461244712448124491245012451124521245312454124551245612457124581245912460124611246212463124641246512466124671246812469124701247112472124731247412475124761247712478124791248012481124821248312484124851248612487124881248912490124911249212493124941249512496124971249812499125001250112502125031250412505125061250712508125091251012511125121251312514125151251612517125181251912520125211252212523125241252512526125271252812529125301253112532125331253412535125361253712538125391254012541125421254312544125451254612547125481254912550125511255212553125541255512556125571255812559125601256112562125631256412565125661256712568125691257012571125721257312574125751257612577125781257912580125811258212583125841258512586125871258812589125901259112592125931259412595125961259712598125991260012601126021260312604126051260612607126081260912610126111261212613126141261512616126171261812619126201262112622126231262412625126261262712628126291263012631126321263312634126351263612637126381263912640126411264212643126441264512646126471264812649126501265112652126531265412655126561265712658126591266012661126621266312664126651266612667126681266912670126711267212673126741267512676126771267812679126801268112682126831268412685126861268712688126891269012691126921269312694126951269612697126981269912700127011270212703127041270512706127071270812709127101271112712127131271412715127161271712718127191272012721127221272312724127251272612727127281272912730127311273212733127341273512736127371273812739127401274112742127431274412745127461274712748127491275012751127521275312754127551275612757127581275912760127611276212763127641276512766127671276812769127701277112772127731277412775127761277712778127791278012781127821278312784127851278612787127881278912790127911279212793127941279512796127971279812799128001280112802128031280412805128061280712808128091281012811128121281312814128151281612817128181281912820128211282212823128241282512826128271282812829128301283112832128331283412835128361283712838128391284012841128421284312844128451284612847128481284912850128511285212853128541285512856128571285812859128601286112862128631286412865128661286712868128691287012871128721287312874128751287612877128781287912880128811288212883128841288512886128871288812889128901289112892128931289412895128961289712898128991290012901129021290312904129051290612907129081290912910129111291212913129141291512916129171291812919129201292112922129231292412925129261292712928129291293012931129321293312934129351293612937129381293912940129411294212943129441294512946129471294812949129501295112952129531295412955129561295712958129591296012961129621296312964129651296612967129681296912970129711297212973129741297512976129771297812979129801298112982129831298412985129861298712988129891299012991129921299312994129951299612997129981299913000130011300213003130041300513006130071300813009130101301113012130131301413015130161301713018130191302013021130221302313024130251302613027130281302913030130311303213033130341303513036130371303813039130401304113042130431304413045130461304713048130491305013051130521305313054130551305613057130581305913060130611306213063130641306513066130671306813069130701307113072130731307413075130761307713078130791308013081130821308313084130851308613087130881308913090130911309213093130941309513096130971309813099131001310113102131031310413105131061310713108131091311013111131121311313114131151311613117131181311913120131211312213123131241312513126131271312813129131301313113132131331313413135131361313713138131391314013141131421314313144131451314613147131481314913150131511315213153131541315513156131571315813159131601316113162131631316413165131661316713168131691317013171131721317313174131751317613177131781317913180131811318213183131841318513186131871318813189131901319113192131931319413195131961319713198131991320013201132021320313204132051320613207132081320913210132111321213213132141321513216132171321813219132201322113222132231322413225132261322713228132291323013231132321323313234132351323613237132381323913240132411324213243132441324513246132471324813249132501325113252132531325413255132561325713258132591326013261132621326313264132651326613267132681326913270132711327213273132741327513276132771327813279132801328113282132831328413285132861328713288132891329013291132921329313294132951329613297132981329913300133011330213303133041330513306133071330813309133101331113312133131331413315133161331713318133191332013321133221332313324133251332613327133281332913330133311333213333133341333513336133371333813339133401334113342133431334413345133461334713348133491335013351133521335313354133551335613357133581335913360133611336213363133641336513366133671336813369133701337113372133731337413375133761337713378133791338013381133821338313384133851338613387133881338913390133911339213393133941339513396133971339813399134001340113402134031340413405134061340713408134091341013411134121341313414134151341613417134181341913420134211342213423134241342513426134271342813429134301343113432134331343413435134361343713438134391344013441134421344313444134451344613447134481344913450134511345213453134541345513456134571345813459134601346113462134631346413465134661346713468134691347013471134721347313474134751347613477134781347913480134811348213483134841348513486134871348813489134901349113492134931349413495134961349713498134991350013501135021350313504135051350613507135081350913510135111351213513135141351513516135171351813519135201352113522135231352413525135261352713528135291353013531135321353313534135351353613537135381353913540135411354213543135441354513546135471354813549135501355113552135531355413555135561355713558135591356013561135621356313564135651356613567135681356913570135711357213573135741357513576135771357813579135801358113582135831358413585135861358713588135891359013591135921359313594135951359613597135981359913600136011360213603136041360513606136071360813609136101361113612136131361413615136161361713618136191362013621136221362313624136251362613627136281362913630136311363213633136341363513636136371363813639136401364113642136431364413645136461364713648136491365013651136521365313654136551365613657136581365913660136611366213663136641366513666136671366813669136701367113672136731367413675136761367713678136791368013681136821368313684136851368613687136881368913690136911369213693136941369513696136971369813699137001370113702137031370413705137061370713708137091371013711137121371313714137151371613717137181371913720137211372213723137241372513726137271372813729137301373113732137331373413735137361373713738137391374013741137421374313744137451374613747137481374913750137511375213753137541375513756137571375813759137601376113762137631376413765137661376713768137691377013771137721377313774137751377613777137781377913780137811378213783137841378513786137871378813789137901379113792137931379413795137961379713798137991380013801138021380313804138051380613807138081380913810138111381213813138141381513816138171381813819138201382113822138231382413825138261382713828138291383013831138321383313834138351383613837138381383913840138411384213843138441384513846138471384813849138501385113852138531385413855138561385713858138591386013861138621386313864138651386613867138681386913870138711387213873138741387513876138771387813879138801388113882138831388413885138861388713888138891389013891138921389313894138951389613897138981389913900139011390213903139041390513906139071390813909139101391113912139131391413915139161391713918139191392013921139221392313924139251392613927139281392913930139311393213933139341393513936139371393813939139401394113942139431394413945139461394713948139491395013951139521395313954139551395613957139581395913960139611396213963139641396513966139671396813969139701397113972139731397413975139761397713978139791398013981139821398313984139851398613987139881398913990139911399213993139941399513996139971399813999140001400114002140031400414005140061400714008140091401014011140121401314014140151401614017140181401914020140211402214023140241402514026140271402814029140301403114032140331403414035140361403714038140391404014041140421404314044140451404614047140481404914050140511405214053140541405514056140571405814059140601406114062140631406414065140661406714068140691407014071140721407314074140751407614077140781407914080140811408214083140841408514086140871408814089140901409114092140931409414095140961409714098140991410014101141021410314104141051410614107141081410914110141111411214113141141411514116141171411814119141201412114122141231412414125141261412714128141291413014131141321413314134141351413614137141381413914140141411414214143141441414514146141471414814149141501415114152141531415414155141561415714158141591416014161141621416314164141651416614167141681416914170141711417214173141741417514176141771417814179141801418114182141831418414185141861418714188141891419014191141921419314194141951419614197141981419914200142011420214203142041420514206142071420814209142101421114212142131421414215142161421714218142191422014221142221422314224142251422614227142281422914230142311423214233142341423514236142371423814239142401424114242142431424414245142461424714248142491425014251142521425314254142551425614257142581425914260142611426214263142641426514266142671426814269142701427114272142731427414275142761427714278142791428014281142821428314284142851428614287142881428914290142911429214293142941429514296142971429814299143001430114302143031430414305143061430714308143091431014311143121431314314143151431614317143181431914320143211432214323143241432514326143271432814329143301433114332143331433414335143361433714338143391434014341143421434314344143451434614347143481434914350143511435214353143541435514356143571435814359143601436114362143631436414365143661436714368143691437014371143721437314374143751437614377143781437914380143811438214383143841438514386143871438814389143901439114392143931439414395143961439714398143991440014401144021440314404144051440614407144081440914410144111441214413144141441514416144171441814419144201442114422144231442414425144261442714428144291443014431144321443314434144351443614437144381443914440144411444214443144441444514446144471444814449144501445114452144531445414455144561445714458144591446014461144621446314464144651446614467144681446914470144711447214473144741447514476144771447814479144801448114482144831448414485144861448714488144891449014491144921449314494144951449614497144981449914500145011450214503145041450514506145071450814509145101451114512145131451414515145161451714518145191452014521145221452314524145251452614527145281452914530145311453214533145341453514536145371453814539145401454114542145431454414545145461454714548145491455014551145521455314554145551455614557145581455914560145611456214563145641456514566145671456814569145701457114572145731457414575145761457714578145791458014581145821458314584145851458614587145881458914590145911459214593145941459514596145971459814599146001460114602146031460414605146061460714608146091461014611146121461314614146151461614617146181461914620146211462214623146241462514626146271462814629146301463114632146331463414635146361463714638146391464014641146421464314644146451464614647146481464914650146511465214653146541465514656146571465814659146601466114662146631466414665146661466714668146691467014671146721467314674146751467614677146781467914680146811468214683146841468514686146871468814689146901469114692146931469414695146961469714698146991470014701147021470314704147051470614707147081470914710147111471214713147141471514716147171471814719147201472114722147231472414725147261472714728147291473014731147321473314734147351473614737147381473914740147411474214743147441474514746147471474814749147501475114752147531475414755147561475714758147591476014761147621476314764147651476614767147681476914770147711477214773147741477514776147771477814779147801478114782147831478414785147861478714788147891479014791147921479314794147951479614797147981479914800148011480214803148041480514806148071480814809148101481114812148131481414815148161481714818148191482014821148221482314824148251482614827148281482914830148311483214833148341483514836148371483814839148401484114842148431484414845148461484714848148491485014851148521485314854148551485614857148581485914860148611486214863148641486514866148671486814869148701487114872148731487414875148761487714878148791488014881148821488314884148851488614887148881488914890148911489214893148941489514896148971489814899149001490114902149031490414905149061490714908149091491014911149121491314914149151491614917149181491914920149211492214923149241492514926149271492814929149301493114932149331493414935149361493714938149391494014941149421494314944149451494614947149481494914950149511495214953149541495514956149571495814959149601496114962149631496414965149661496714968149691497014971149721497314974149751497614977149781497914980149811498214983149841498514986149871498814989149901499114992149931499414995149961499714998149991500015001150021500315004150051500615007150081500915010150111501215013150141501515016150171501815019150201502115022150231502415025150261502715028150291503015031150321503315034150351503615037150381503915040150411504215043150441504515046150471504815049150501505115052150531505415055150561505715058150591506015061150621506315064150651506615067150681506915070150711507215073150741507515076150771507815079150801508115082150831508415085150861508715088150891509015091150921509315094150951509615097150981509915100151011510215103151041510515106151071510815109151101511115112151131511415115151161511715118151191512015121151221512315124151251512615127151281512915130151311513215133151341513515136151371513815139151401514115142151431514415145151461514715148151491515015151151521515315154151551515615157151581515915160151611516215163151641516515166151671516815169151701517115172151731517415175151761517715178151791518015181151821518315184151851518615187151881518915190151911519215193151941519515196151971519815199152001520115202152031520415205152061520715208152091521015211152121521315214152151521615217152181521915220152211522215223152241522515226152271522815229152301523115232152331523415235152361523715238152391524015241152421524315244152451524615247152481524915250152511525215253152541525515256152571525815259152601526115262152631526415265152661526715268152691527015271152721527315274152751527615277152781527915280152811528215283152841528515286152871528815289152901529115292152931529415295152961529715298152991530015301153021530315304153051530615307153081530915310153111531215313153141531515316153171531815319153201532115322153231532415325153261532715328153291533015331153321533315334153351533615337153381533915340153411534215343153441534515346153471534815349153501535115352153531535415355153561535715358153591536015361153621536315364153651536615367153681536915370153711537215373153741537515376153771537815379153801538115382153831538415385153861538715388153891539015391153921539315394153951539615397153981539915400154011540215403154041540515406154071540815409154101541115412154131541415415154161541715418154191542015421154221542315424154251542615427154281542915430154311543215433154341543515436154371543815439154401544115442154431544415445154461544715448154491545015451154521545315454154551545615457154581545915460154611546215463154641546515466154671546815469154701547115472154731547415475154761547715478154791548015481154821548315484154851548615487154881548915490154911549215493154941549515496154971549815499155001550115502155031550415505155061550715508155091551015511155121551315514155151551615517155181551915520155211552215523155241552515526155271552815529155301553115532155331553415535155361553715538155391554015541155421554315544155451554615547155481554915550155511555215553155541555515556155571555815559155601556115562155631556415565155661556715568155691557015571155721557315574155751557615577155781557915580155811558215583155841558515586155871558815589155901559115592155931559415595155961559715598155991560015601156021560315604156051560615607156081560915610156111561215613156141561515616156171561815619156201562115622156231562415625156261562715628156291563015631156321563315634156351563615637156381563915640156411564215643156441564515646156471564815649156501565115652156531565415655156561565715658156591566015661156621566315664156651566615667156681566915670156711567215673156741567515676156771567815679156801568115682156831568415685156861568715688156891569015691156921569315694156951569615697156981569915700157011570215703157041570515706157071570815709157101571115712157131571415715157161571715718157191572015721157221572315724157251572615727157281572915730157311573215733157341573515736157371573815739157401574115742157431574415745157461574715748157491575015751157521575315754157551575615757157581575915760157611576215763157641576515766157671576815769157701577115772157731577415775157761577715778157791578015781157821578315784157851578615787157881578915790157911579215793157941579515796157971579815799158001580115802158031580415805158061580715808158091581015811158121581315814158151581615817158181581915820158211582215823158241582515826158271582815829158301583115832158331583415835158361583715838158391584015841158421584315844158451584615847158481584915850158511585215853158541585515856158571585815859158601586115862158631586415865158661586715868158691587015871158721587315874158751587615877158781587915880158811588215883158841588515886158871588815889158901589115892158931589415895158961589715898158991590015901159021590315904159051590615907159081590915910159111591215913159141591515916159171591815919159201592115922159231592415925159261592715928159291593015931159321593315934159351593615937159381593915940159411594215943159441594515946159471594815949159501595115952159531595415955159561595715958159591596015961159621596315964159651596615967159681596915970159711597215973159741597515976159771597815979159801598115982159831598415985159861598715988159891599015991159921599315994159951599615997159981599916000160011600216003160041600516006160071600816009160101601116012160131601416015160161601716018160191602016021160221602316024160251602616027160281602916030160311603216033160341603516036160371603816039160401604116042160431604416045160461604716048160491605016051160521605316054160551605616057160581605916060160611606216063160641606516066160671606816069160701607116072160731607416075160761607716078160791608016081160821608316084160851608616087160881608916090160911609216093160941609516096160971609816099161001610116102161031610416105161061610716108161091611016111161121611316114161151611616117161181611916120161211612216123161241612516126161271612816129161301613116132161331613416135161361613716138161391614016141161421614316144161451614616147161481614916150161511615216153161541615516156161571615816159161601616116162161631616416165161661616716168161691617016171161721617316174161751617616177161781617916180161811618216183161841618516186161871618816189161901619116192161931619416195161961619716198161991620016201162021620316204162051620616207162081620916210162111621216213162141621516216162171621816219162201622116222162231622416225162261622716228162291623016231162321623316234162351623616237162381623916240162411624216243162441624516246162471624816249162501625116252162531625416255162561625716258162591626016261162621626316264162651626616267162681626916270162711627216273162741627516276162771627816279162801628116282162831628416285162861628716288162891629016291162921629316294162951629616297162981629916300163011630216303163041630516306163071630816309163101631116312163131631416315163161631716318163191632016321163221632316324163251632616327163281632916330163311633216333163341633516336163371633816339163401634116342163431634416345163461634716348163491635016351163521635316354163551635616357163581635916360163611636216363163641636516366163671636816369163701637116372163731637416375163761637716378163791638016381163821638316384163851638616387163881638916390163911639216393163941639516396163971639816399164001640116402164031640416405164061640716408164091641016411164121641316414164151641616417164181641916420164211642216423164241642516426164271642816429164301643116432164331643416435164361643716438164391644016441164421644316444164451644616447164481644916450164511645216453164541645516456164571645816459164601646116462164631646416465164661646716468164691647016471164721647316474164751647616477164781647916480164811648216483164841648516486164871648816489164901649116492164931649416495164961649716498164991650016501165021650316504165051650616507165081650916510165111651216513165141651516516165171651816519165201652116522165231652416525165261652716528165291653016531165321653316534165351653616537165381653916540165411654216543165441654516546165471654816549165501655116552165531655416555165561655716558165591656016561165621656316564165651656616567165681656916570165711657216573165741657516576165771657816579165801658116582165831658416585165861658716588165891659016591165921659316594165951659616597165981659916600166011660216603166041660516606166071660816609166101661116612166131661416615166161661716618166191662016621166221662316624166251662616627166281662916630166311663216633166341663516636166371663816639166401664116642166431664416645166461664716648166491665016651166521665316654166551665616657166581665916660166611666216663166641666516666166671666816669166701667116672166731667416675166761667716678166791668016681166821668316684166851668616687166881668916690166911669216693166941669516696166971669816699167001670116702167031670416705167061670716708167091671016711167121671316714167151671616717167181671916720167211672216723167241672516726167271672816729167301673116732167331673416735167361673716738167391674016741167421674316744167451674616747167481674916750167511675216753167541675516756167571675816759167601676116762167631676416765167661676716768167691677016771167721677316774167751677616777167781677916780167811678216783167841678516786167871678816789167901679116792167931679416795167961679716798167991680016801168021680316804168051680616807168081680916810168111681216813168141681516816168171681816819168201682116822168231682416825168261682716828168291683016831168321683316834168351683616837168381683916840168411684216843168441684516846168471684816849168501685116852168531685416855168561685716858168591686016861168621686316864168651686616867168681686916870168711687216873168741687516876168771687816879168801688116882168831688416885168861688716888168891689016891168921689316894168951689616897168981689916900169011690216903169041690516906169071690816909169101691116912169131691416915169161691716918169191692016921169221692316924169251692616927169281692916930169311693216933169341693516936169371693816939169401694116942169431694416945169461694716948169491695016951169521695316954169551695616957169581695916960169611696216963169641696516966169671696816969169701697116972169731697416975169761697716978169791698016981169821698316984169851698616987169881698916990169911699216993169941699516996169971699816999170001700117002170031700417005170061700717008170091701017011170121701317014170151701617017170181701917020170211702217023170241702517026170271702817029170301703117032170331703417035170361703717038170391704017041170421704317044170451704617047170481704917050170511705217053170541705517056170571705817059170601706117062170631706417065170661706717068170691707017071170721707317074170751707617077170781707917080170811708217083170841708517086170871708817089170901709117092170931709417095170961709717098170991710017101171021710317104171051710617107171081710917110171111711217113171141711517116171171711817119171201712117122171231712417125171261712717128171291713017131171321713317134171351713617137171381713917140171411714217143171441714517146171471714817149171501715117152171531715417155171561715717158171591716017161171621716317164171651716617167171681716917170171711717217173171741717517176171771717817179171801718117182171831718417185171861718717188171891719017191171921719317194171951719617197171981719917200172011720217203172041720517206172071720817209172101721117212172131721417215172161721717218172191722017221172221722317224172251722617227172281722917230172311723217233172341723517236172371723817239172401724117242172431724417245172461724717248172491725017251172521725317254172551725617257172581725917260172611726217263172641726517266172671726817269172701727117272172731727417275172761727717278172791728017281172821728317284172851728617287172881728917290172911729217293172941729517296172971729817299173001730117302173031730417305173061730717308173091731017311173121731317314173151731617317173181731917320173211732217323173241732517326173271732817329173301733117332173331733417335173361733717338173391734017341173421734317344173451734617347173481734917350173511735217353173541735517356173571735817359173601736117362173631736417365173661736717368173691737017371173721737317374173751737617377173781737917380173811738217383173841738517386173871738817389173901739117392173931739417395173961739717398173991740017401174021740317404174051740617407174081740917410174111741217413174141741517416174171741817419174201742117422174231742417425174261742717428174291743017431174321743317434174351743617437174381743917440174411744217443174441744517446174471744817449174501745117452174531745417455174561745717458174591746017461174621746317464174651746617467174681746917470174711747217473174741747517476174771747817479174801748117482174831748417485174861748717488174891749017491174921749317494174951749617497174981749917500175011750217503175041750517506175071750817509175101751117512175131751417515175161751717518175191752017521175221752317524175251752617527175281752917530175311753217533175341753517536175371753817539175401754117542175431754417545175461754717548175491755017551175521755317554175551755617557175581755917560175611756217563175641756517566175671756817569175701757117572175731757417575175761757717578175791758017581175821758317584175851758617587175881758917590175911759217593175941759517596175971759817599176001760117602176031760417605176061760717608176091761017611176121761317614176151761617617176181761917620176211762217623176241762517626176271762817629176301763117632176331763417635176361763717638176391764017641176421764317644176451764617647176481764917650176511765217653176541765517656176571765817659176601766117662176631766417665176661766717668176691767017671176721767317674176751767617677176781767917680176811768217683176841768517686176871768817689176901769117692176931769417695176961769717698176991770017701177021770317704177051770617707177081770917710177111771217713177141771517716177171771817719177201772117722177231772417725177261772717728177291773017731177321773317734177351773617737177381773917740177411774217743177441774517746177471774817749177501775117752177531775417755177561775717758177591776017761177621776317764177651776617767177681776917770177711777217773177741777517776177771777817779177801778117782177831778417785177861778717788177891779017791177921779317794177951779617797177981779917800178011780217803178041780517806178071780817809178101781117812178131781417815178161781717818178191782017821178221782317824178251782617827178281782917830178311783217833178341783517836178371783817839178401784117842178431784417845178461784717848178491785017851178521785317854178551785617857178581785917860178611786217863178641786517866178671786817869178701787117872178731787417875178761787717878178791788017881178821788317884178851788617887178881788917890178911789217893178941789517896178971789817899179001790117902179031790417905179061790717908179091791017911179121791317914179151791617917179181791917920179211792217923179241792517926179271792817929179301793117932179331793417935179361793717938179391794017941179421794317944179451794617947179481794917950179511795217953179541795517956179571795817959179601796117962179631796417965179661796717968179691797017971179721797317974179751797617977179781797917980179811798217983179841798517986179871798817989179901799117992179931799417995179961799717998179991800018001180021800318004180051800618007180081800918010180111801218013180141801518016180171801818019180201802118022180231802418025180261802718028180291803018031180321803318034180351803618037180381803918040180411804218043180441804518046180471804818049180501805118052180531805418055180561805718058180591806018061180621806318064180651806618067180681806918070180711807218073180741807518076180771807818079180801808118082180831808418085180861808718088180891809018091180921809318094180951809618097180981809918100181011810218103181041810518106181071810818109181101811118112181131811418115181161811718118181191812018121181221812318124181251812618127181281812918130181311813218133181341813518136181371813818139181401814118142181431814418145181461814718148181491815018151181521815318154181551815618157181581815918160181611816218163181641816518166181671816818169181701817118172181731817418175181761817718178181791818018181181821818318184181851818618187181881818918190181911819218193181941819518196181971819818199182001820118202182031820418205182061820718208182091821018211182121821318214182151821618217182181821918220182211822218223182241822518226182271822818229182301823118232182331823418235182361823718238182391824018241182421824318244182451824618247182481824918250182511825218253182541825518256182571825818259182601826118262182631826418265182661826718268182691827018271182721827318274182751827618277182781827918280182811828218283182841828518286182871828818289182901829118292182931829418295182961829718298182991830018301183021830318304183051830618307183081830918310183111831218313183141831518316183171831818319183201832118322183231832418325183261832718328183291833018331183321833318334183351833618337183381833918340183411834218343183441834518346183471834818349183501835118352183531835418355183561835718358183591836018361183621836318364183651836618367183681836918370183711837218373183741837518376183771837818379183801838118382183831838418385183861838718388183891839018391183921839318394183951839618397183981839918400184011840218403184041840518406184071840818409184101841118412184131841418415184161841718418184191842018421184221842318424184251842618427184281842918430184311843218433184341843518436184371843818439184401844118442184431844418445184461844718448184491845018451184521845318454184551845618457184581845918460184611846218463184641846518466184671846818469184701847118472184731847418475184761847718478184791848018481184821848318484184851848618487184881848918490184911849218493184941849518496184971849818499185001850118502185031850418505185061850718508185091851018511185121851318514185151851618517185181851918520185211852218523185241852518526185271852818529185301853118532185331853418535185361853718538185391854018541185421854318544185451854618547185481854918550185511855218553185541855518556185571855818559185601856118562185631856418565185661856718568185691857018571185721857318574185751857618577185781857918580185811858218583185841858518586185871858818589185901859118592185931859418595185961859718598185991860018601186021860318604186051860618607186081860918610186111861218613186141861518616186171861818619186201862118622186231862418625186261862718628186291863018631186321863318634186351863618637186381863918640186411864218643186441864518646186471864818649186501865118652186531865418655186561865718658186591866018661186621866318664186651866618667186681866918670186711867218673186741867518676186771867818679186801868118682186831868418685186861868718688186891869018691186921869318694186951869618697186981869918700187011870218703187041870518706187071870818709187101871118712187131871418715187161871718718187191872018721187221872318724187251872618727187281872918730187311873218733187341873518736187371873818739187401874118742187431874418745187461874718748187491875018751187521875318754187551875618757187581875918760187611876218763187641876518766187671876818769187701877118772187731877418775187761877718778187791878018781187821878318784187851878618787187881878918790187911879218793187941879518796187971879818799188001880118802188031880418805188061880718808188091881018811188121881318814188151881618817188181881918820188211882218823188241882518826188271882818829188301883118832188331883418835188361883718838188391884018841188421884318844188451884618847188481884918850188511885218853188541885518856188571885818859188601886118862188631886418865188661886718868188691887018871188721887318874188751887618877188781887918880188811888218883188841888518886188871888818889188901889118892188931889418895188961889718898188991890018901189021890318904189051890618907189081890918910189111891218913189141891518916189171891818919189201892118922189231892418925189261892718928189291893018931189321893318934189351893618937189381893918940189411894218943189441894518946189471894818949189501895118952189531895418955189561895718958189591896018961189621896318964189651896618967189681896918970189711897218973189741897518976189771897818979189801898118982189831898418985189861898718988189891899018991189921899318994189951899618997189981899919000190011900219003190041900519006190071900819009190101901119012190131901419015190161901719018190191902019021190221902319024190251902619027190281902919030190311903219033190341903519036190371903819039190401904119042190431904419045190461904719048190491905019051190521905319054190551905619057190581905919060190611906219063190641906519066190671906819069190701907119072190731907419075190761907719078190791908019081190821908319084190851908619087190881908919090190911909219093190941909519096190971909819099191001910119102191031910419105191061910719108191091911019111191121911319114191151911619117191181911919120191211912219123191241912519126191271912819129191301913119132191331913419135191361913719138191391914019141191421914319144191451914619147191481914919150191511915219153191541915519156191571915819159191601916119162191631916419165191661916719168191691917019171191721917319174191751917619177191781917919180191811918219183191841918519186191871918819189191901919119192191931919419195191961919719198191991920019201192021920319204192051920619207192081920919210192111921219213192141921519216192171921819219192201922119222192231922419225192261922719228192291923019231192321923319234192351923619237192381923919240192411924219243192441924519246192471924819249192501925119252192531925419255192561925719258192591926019261192621926319264192651926619267192681926919270192711927219273192741927519276192771927819279192801928119282192831928419285192861928719288192891929019291192921929319294192951929619297192981929919300193011930219303193041930519306193071930819309193101931119312193131931419315193161931719318193191932019321193221932319324193251932619327193281932919330193311933219333193341933519336193371933819339193401934119342193431934419345193461934719348193491935019351193521935319354193551935619357193581935919360193611936219363193641936519366193671936819369193701937119372193731937419375193761937719378193791938019381193821938319384193851938619387193881938919390193911939219393193941939519396193971939819399194001940119402194031940419405194061940719408194091941019411194121941319414194151941619417194181941919420194211942219423194241942519426194271942819429194301943119432194331943419435194361943719438194391944019441194421944319444194451944619447194481944919450194511945219453194541945519456194571945819459194601946119462194631946419465194661946719468194691947019471194721947319474194751947619477194781947919480194811948219483194841948519486194871948819489194901949119492194931949419495194961949719498194991950019501195021950319504195051950619507195081950919510195111951219513195141951519516195171951819519195201952119522195231952419525195261952719528195291953019531195321953319534195351953619537195381953919540195411954219543195441954519546195471954819549195501955119552195531955419555195561955719558195591956019561195621956319564195651956619567195681956919570195711957219573195741957519576195771957819579195801958119582195831958419585195861958719588195891959019591195921959319594195951959619597195981959919600196011960219603196041960519606196071960819609196101961119612196131961419615196161961719618196191962019621196221962319624196251962619627196281962919630196311963219633196341963519636196371963819639196401964119642196431964419645196461964719648196491965019651196521965319654196551965619657196581965919660196611966219663196641966519666196671966819669196701967119672196731967419675196761967719678196791968019681196821968319684196851968619687196881968919690196911969219693196941969519696196971969819699197001970119702197031970419705197061970719708197091971019711197121971319714197151971619717197181971919720197211972219723197241972519726197271972819729197301973119732197331973419735197361973719738197391974019741197421974319744197451974619747197481974919750197511975219753197541975519756197571975819759197601976119762197631976419765197661976719768197691977019771197721977319774197751977619777197781977919780197811978219783197841978519786197871978819789197901979119792197931979419795197961979719798197991980019801198021980319804198051980619807198081980919810198111981219813198141981519816198171981819819198201982119822198231982419825198261982719828198291983019831198321983319834198351983619837198381983919840198411984219843198441984519846198471984819849198501985119852198531985419855198561985719858198591986019861198621986319864198651986619867198681986919870198711987219873198741987519876198771987819879198801988119882198831988419885198861988719888198891989019891198921989319894198951989619897198981989919900199011990219903199041990519906199071990819909199101991119912199131991419915199161991719918199191992019921199221992319924199251992619927199281992919930199311993219933199341993519936199371993819939199401994119942199431994419945199461994719948199491995019951199521995319954199551995619957199581995919960199611996219963199641996519966199671996819969199701997119972199731997419975199761997719978199791998019981199821998319984199851998619987199881998919990199911999219993199941999519996199971999819999200002000120002200032000420005200062000720008200092001020011200122001320014200152001620017200182001920020200212002220023200242002520026200272002820029200302003120032200332003420035200362003720038200392004020041200422004320044200452004620047200482004920050200512005220053200542005520056200572005820059200602006120062200632006420065200662006720068200692007020071200722007320074200752007620077200782007920080200812008220083200842008520086200872008820089200902009120092200932009420095200962009720098200992010020101201022010320104201052010620107201082010920110201112011220113201142011520116201172011820119201202012120122201232012420125201262012720128201292013020131201322013320134201352013620137201382013920140201412014220143201442014520146201472014820149201502015120152201532015420155201562015720158201592016020161201622016320164201652016620167201682016920170201712017220173201742017520176201772017820179201802018120182201832018420185201862018720188201892019020191201922019320194201952019620197201982019920200202012020220203202042020520206202072020820209202102021120212202132021420215202162021720218202192022020221202222022320224202252022620227202282022920230202312023220233202342023520236202372023820239202402024120242202432024420245202462024720248202492025020251202522025320254202552025620257202582025920260202612026220263202642026520266202672026820269202702027120272202732027420275202762027720278202792028020281202822028320284202852028620287202882028920290202912029220293202942029520296202972029820299203002030120302203032030420305203062030720308203092031020311203122031320314203152031620317203182031920320203212032220323203242032520326203272032820329203302033120332203332033420335203362033720338203392034020341203422034320344203452034620347203482034920350203512035220353203542035520356203572035820359203602036120362203632036420365203662036720368203692037020371203722037320374203752037620377203782037920380203812038220383203842038520386203872038820389203902039120392203932039420395203962039720398203992040020401204022040320404204052040620407204082040920410204112041220413204142041520416204172041820419204202042120422204232042420425204262042720428204292043020431204322043320434204352043620437204382043920440204412044220443204442044520446204472044820449204502045120452204532045420455204562045720458204592046020461204622046320464204652046620467204682046920470204712047220473204742047520476204772047820479204802048120482204832048420485204862048720488204892049020491204922049320494204952049620497204982049920500205012050220503205042050520506205072050820509205102051120512205132051420515205162051720518205192052020521205222052320524205252052620527205282052920530205312053220533205342053520536205372053820539205402054120542205432054420545205462054720548205492055020551205522055320554205552055620557205582055920560205612056220563205642056520566205672056820569205702057120572205732057420575205762057720578205792058020581205822058320584205852058620587205882058920590205912059220593205942059520596205972059820599206002060120602206032060420605206062060720608206092061020611206122061320614206152061620617206182061920620206212062220623206242062520626206272062820629206302063120632206332063420635206362063720638206392064020641206422064320644206452064620647206482064920650206512065220653206542065520656206572065820659206602066120662206632066420665206662066720668206692067020671206722067320674206752067620677206782067920680206812068220683206842068520686206872068820689206902069120692206932069420695206962069720698206992070020701207022070320704207052070620707207082070920710207112071220713207142071520716207172071820719207202072120722207232072420725207262072720728207292073020731207322073320734207352073620737207382073920740207412074220743207442074520746207472074820749207502075120752207532075420755207562075720758207592076020761207622076320764207652076620767207682076920770207712077220773207742077520776207772077820779207802078120782207832078420785207862078720788207892079020791207922079320794207952079620797207982079920800208012080220803208042080520806208072080820809208102081120812208132081420815208162081720818208192082020821208222082320824208252082620827208282082920830208312083220833208342083520836208372083820839208402084120842208432084420845208462084720848208492085020851208522085320854208552085620857208582085920860208612086220863208642086520866208672086820869208702087120872208732087420875208762087720878208792088020881208822088320884208852088620887208882088920890208912089220893208942089520896208972089820899209002090120902209032090420905209062090720908209092091020911209122091320914209152091620917209182091920920209212092220923209242092520926209272092820929209302093120932209332093420935209362093720938209392094020941209422094320944209452094620947209482094920950209512095220953209542095520956209572095820959209602096120962209632096420965209662096720968209692097020971209722097320974209752097620977209782097920980209812098220983209842098520986209872098820989209902099120992209932099420995209962099720998209992100021001210022100321004210052100621007210082100921010210112101221013210142101521016210172101821019210202102121022210232102421025210262102721028210292103021031210322103321034210352103621037210382103921040210412104221043210442104521046210472104821049210502105121052210532105421055210562105721058210592106021061210622106321064210652106621067210682106921070210712107221073210742107521076210772107821079210802108121082210832108421085210862108721088210892109021091210922109321094210952109621097210982109921100211012110221103211042110521106211072110821109211102111121112211132111421115211162111721118211192112021121211222112321124211252112621127211282112921130211312113221133211342113521136211372113821139211402114121142211432114421145211462114721148211492115021151211522115321154211552115621157211582115921160211612116221163211642116521166211672116821169211702117121172211732117421175211762117721178211792118021181211822118321184211852118621187211882118921190211912119221193211942119521196211972119821199212002120121202212032120421205212062120721208212092121021211212122121321214212152121621217212182121921220212212122221223212242122521226212272122821229212302123121232212332123421235212362123721238212392124021241212422124321244212452124621247212482124921250212512125221253212542125521256212572125821259212602126121262212632126421265212662126721268212692127021271212722127321274212752127621277212782127921280212812128221283212842128521286212872128821289212902129121292212932129421295212962129721298212992130021301213022130321304213052130621307213082130921310213112131221313213142131521316213172131821319213202132121322213232132421325213262132721328213292133021331213322133321334213352133621337213382133921340213412134221343213442134521346213472134821349213502135121352213532135421355213562135721358213592136021361213622136321364213652136621367213682136921370213712137221373213742137521376213772137821379213802138121382213832138421385213862138721388213892139021391213922139321394213952139621397213982139921400214012140221403214042140521406214072140821409214102141121412214132141421415214162141721418214192142021421214222142321424214252142621427214282142921430214312143221433214342143521436214372143821439214402144121442214432144421445214462144721448214492145021451214522145321454214552145621457214582145921460214612146221463214642146521466214672146821469214702147121472214732147421475214762147721478214792148021481214822148321484214852148621487214882148921490214912149221493214942149521496214972149821499215002150121502215032150421505215062150721508215092151021511215122151321514215152151621517215182151921520215212152221523215242152521526215272152821529215302153121532215332153421535215362153721538215392154021541215422154321544215452154621547215482154921550215512155221553215542155521556215572155821559215602156121562215632156421565215662156721568215692157021571215722157321574215752157621577215782157921580215812158221583215842158521586215872158821589215902159121592215932159421595215962159721598215992160021601216022160321604216052160621607216082160921610216112161221613216142161521616216172161821619216202162121622216232162421625216262162721628216292163021631216322163321634216352163621637216382163921640216412164221643216442164521646216472164821649216502165121652216532165421655216562165721658216592166021661216622166321664216652166621667216682166921670216712167221673216742167521676216772167821679216802168121682216832168421685216862168721688216892169021691216922169321694216952169621697216982169921700217012170221703217042170521706217072170821709217102171121712217132171421715217162171721718217192172021721217222172321724217252172621727217282172921730217312173221733217342173521736217372173821739217402174121742217432174421745217462174721748217492175021751217522175321754217552175621757217582175921760217612176221763217642176521766217672176821769217702177121772217732177421775217762177721778217792178021781217822178321784217852178621787217882178921790217912179221793217942179521796217972179821799218002180121802218032180421805218062180721808218092181021811218122181321814218152181621817218182181921820218212182221823218242182521826218272182821829218302183121832218332183421835218362183721838218392184021841218422184321844218452184621847218482184921850218512185221853218542185521856218572185821859218602186121862218632186421865218662186721868218692187021871218722187321874218752187621877218782187921880218812188221883218842188521886218872188821889218902189121892218932189421895218962189721898218992190021901219022190321904219052190621907219082190921910219112191221913219142191521916219172191821919219202192121922219232192421925219262192721928219292193021931219322193321934219352193621937219382193921940219412194221943219442194521946219472194821949219502195121952219532195421955219562195721958219592196021961219622196321964219652196621967219682196921970219712197221973219742197521976219772197821979219802198121982219832198421985219862198721988219892199021991219922199321994219952199621997219982199922000220012200222003220042200522006220072200822009220102201122012220132201422015220162201722018220192202022021220222202322024220252202622027220282202922030220312203222033220342203522036220372203822039220402204122042220432204422045220462204722048220492205022051220522205322054220552205622057220582205922060220612206222063220642206522066220672206822069220702207122072220732207422075220762207722078220792208022081220822208322084220852208622087220882208922090220912209222093220942209522096220972209822099221002210122102221032210422105221062210722108221092211022111221122211322114221152211622117221182211922120221212212222123221242212522126221272212822129221302213122132221332213422135221362213722138221392214022141221422214322144221452214622147221482214922150221512215222153221542215522156221572215822159221602216122162221632216422165221662216722168221692217022171221722217322174221752217622177221782217922180221812218222183221842218522186221872218822189221902219122192221932219422195221962219722198221992220022201222022220322204222052220622207222082220922210222112221222213222142221522216222172221822219222202222122222222232222422225222262222722228222292223022231222322223322234222352223622237222382223922240222412224222243222442224522246222472224822249222502225122252222532225422255222562225722258222592226022261222622226322264222652226622267222682226922270222712227222273222742227522276222772227822279222802228122282222832228422285222862228722288222892229022291222922229322294222952229622297222982229922300223012230222303223042230522306223072230822309223102231122312223132231422315223162231722318223192232022321223222232322324223252232622327223282232922330223312233222333223342233522336223372233822339223402234122342223432234422345223462234722348223492235022351223522235322354223552235622357223582235922360223612236222363223642236522366223672236822369223702237122372223732237422375223762237722378223792238022381223822238322384223852238622387223882238922390223912239222393223942239522396223972239822399224002240122402224032240422405224062240722408224092241022411224122241322414224152241622417224182241922420224212242222423224242242522426224272242822429224302243122432224332243422435224362243722438224392244022441224422244322444224452244622447224482244922450224512245222453224542245522456224572245822459224602246122462224632246422465224662246722468224692247022471224722247322474224752247622477224782247922480224812248222483224842248522486224872248822489224902249122492224932249422495224962249722498224992250022501225022250322504225052250622507225082250922510225112251222513225142251522516225172251822519225202252122522225232252422525225262252722528225292253022531225322253322534225352253622537225382253922540225412254222543225442254522546225472254822549225502255122552225532255422555225562255722558225592256022561225622256322564225652256622567225682256922570225712257222573225742257522576225772257822579225802258122582225832258422585225862258722588225892259022591225922259322594225952259622597225982259922600226012260222603226042260522606226072260822609226102261122612226132261422615226162261722618226192262022621226222262322624226252262622627226282262922630226312263222633226342263522636226372263822639226402264122642226432264422645226462264722648226492265022651226522265322654226552265622657226582265922660226612266222663226642266522666226672266822669226702267122672226732267422675226762267722678226792268022681226822268322684226852268622687226882268922690226912269222693226942269522696226972269822699227002270122702227032270422705227062270722708227092271022711227122271322714227152271622717227182271922720227212272222723227242272522726227272272822729227302273122732227332273422735227362273722738227392274022741227422274322744227452274622747227482274922750227512275222753227542275522756227572275822759227602276122762227632276422765227662276722768227692277022771227722277322774227752277622777227782277922780227812278222783227842278522786227872278822789227902279122792227932279422795227962279722798227992280022801228022280322804228052280622807228082280922810228112281222813228142281522816228172281822819228202282122822228232282422825228262282722828228292283022831228322283322834228352283622837228382283922840228412284222843228442284522846228472284822849228502285122852228532285422855228562285722858228592286022861228622286322864228652286622867228682286922870228712287222873228742287522876228772287822879228802288122882228832288422885228862288722888228892289022891228922289322894228952289622897228982289922900229012290222903229042290522906229072290822909229102291122912229132291422915229162291722918229192292022921229222292322924229252292622927229282292922930229312293222933229342293522936229372293822939229402294122942229432294422945229462294722948229492295022951229522295322954229552295622957229582295922960229612296222963229642296522966229672296822969229702297122972229732297422975229762297722978229792298022981229822298322984229852298622987229882298922990229912299222993229942299522996229972299822999230002300123002230032300423005230062300723008230092301023011230122301323014230152301623017230182301923020230212302223023230242302523026230272302823029230302303123032230332303423035230362303723038230392304023041230422304323044230452304623047230482304923050230512305223053230542305523056230572305823059230602306123062230632306423065230662306723068230692307023071230722307323074230752307623077230782307923080230812308223083230842308523086230872308823089230902309123092230932309423095230962309723098230992310023101231022310323104231052310623107231082310923110231112311223113231142311523116231172311823119231202312123122231232312423125231262312723128231292313023131231322313323134231352313623137231382313923140231412314223143231442314523146231472314823149231502315123152231532315423155231562315723158231592316023161231622316323164231652316623167231682316923170231712317223173231742317523176231772317823179231802318123182231832318423185231862318723188231892319023191231922319323194231952319623197231982319923200232012320223203232042320523206232072320823209232102321123212232132321423215232162321723218232192322023221232222322323224232252322623227232282322923230232312323223233232342323523236232372323823239232402324123242232432324423245232462324723248232492325023251232522325323254232552325623257232582325923260232612326223263232642326523266232672326823269232702327123272232732327423275232762327723278232792328023281232822328323284232852328623287232882328923290232912329223293232942329523296232972329823299233002330123302233032330423305233062330723308233092331023311233122331323314233152331623317233182331923320233212332223323233242332523326233272332823329233302333123332233332333423335233362333723338233392334023341233422334323344233452334623347233482334923350233512335223353233542335523356233572335823359233602336123362233632336423365233662336723368233692337023371233722337323374233752337623377233782337923380233812338223383233842338523386233872338823389233902339123392233932339423395233962339723398233992340023401234022340323404234052340623407234082340923410234112341223413234142341523416234172341823419234202342123422234232342423425234262342723428234292343023431234322343323434234352343623437234382343923440234412344223443234442344523446234472344823449234502345123452234532345423455234562345723458234592346023461234622346323464234652346623467234682346923470234712347223473234742347523476234772347823479234802348123482234832348423485234862348723488234892349023491234922349323494234952349623497234982349923500235012350223503235042350523506235072350823509235102351123512235132351423515235162351723518235192352023521235222352323524235252352623527235282352923530235312353223533235342353523536235372353823539235402354123542235432354423545235462354723548235492355023551235522355323554235552355623557235582355923560235612356223563235642356523566235672356823569235702357123572235732357423575235762357723578235792358023581235822358323584235852358623587235882358923590235912359223593235942359523596235972359823599236002360123602236032360423605236062360723608236092361023611236122361323614236152361623617
  1. <!doctype html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta content="IE=edge,chrome=1" http-equiv="X-UA-Compatible">
  6. <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
  7. <title>Wekan REST API v6.99</title>
  8. <style>
  9. </style>
  10. <style media="screen">/*! normalize.css v3.0.2 | MIT License | git.io/normalize */
  11. /**
  12. * 1. Set default font family to sans-serif.
  13. * 2. Prevent iOS text size adjust after orientation change, without disabling
  14. * user zoom.
  15. */
  16. html {
  17. font-family: sans-serif;
  18. /* 1 */
  19. -ms-text-size-adjust: 100%;
  20. /* 2 */
  21. -webkit-text-size-adjust: 100%;
  22. /* 2 */ }
  23. /**
  24. * Remove default margin.
  25. */
  26. body {
  27. margin: 0; }
  28. /* HTML5 display definitions
  29. ========================================================================== */
  30. /**
  31. * Correct `block` display not defined for any HTML5 element in IE 8/9.
  32. * Correct `block` display not defined for `details` or `summary` in IE 10/11
  33. * and Firefox.
  34. * Correct `block` display not defined for `main` in IE 11.
  35. */
  36. article,
  37. aside,
  38. details,
  39. figcaption,
  40. figure,
  41. footer,
  42. header,
  43. hgroup,
  44. main,
  45. menu,
  46. nav,
  47. section,
  48. summary {
  49. display: block; }
  50. /**
  51. * 1. Correct `inline-block` display not defined in IE 8/9.
  52. * 2. Normalize vertical alignment of `progress` in Chrome, Firefox, and Opera.
  53. */
  54. audio,
  55. canvas,
  56. progress,
  57. video {
  58. display: inline-block;
  59. /* 1 */
  60. vertical-align: baseline;
  61. /* 2 */ }
  62. /**
  63. * Prevent modern browsers from displaying `audio` without controls.
  64. * Remove excess height in iOS 5 devices.
  65. */
  66. audio:not([controls]) {
  67. display: none;
  68. height: 0; }
  69. /**
  70. * Address `[hidden]` styling not present in IE 8/9/10.
  71. * Hide the `template` element in IE 8/9/11, Safari, and Firefox < 22.
  72. */
  73. [hidden],
  74. template {
  75. display: none; }
  76. /* Links
  77. ========================================================================== */
  78. /**
  79. * Remove the gray background color from active links in IE 10.
  80. */
  81. a {
  82. background-color: transparent; }
  83. /**
  84. * Improve readability when focused and also mouse hovered in all browsers.
  85. */
  86. a:active,
  87. a:hover {
  88. outline: 0; }
  89. /* Text-level semantics
  90. ========================================================================== */
  91. /**
  92. * Address styling not present in IE 8/9/10/11, Safari, and Chrome.
  93. */
  94. abbr[title] {
  95. border-bottom: 1px dotted; }
  96. /**
  97. * Address style set to `bolder` in Firefox 4+, Safari, and Chrome.
  98. */
  99. b,
  100. strong {
  101. font-weight: bold; }
  102. /**
  103. * Address styling not present in Safari and Chrome.
  104. */
  105. dfn {
  106. font-style: italic; }
  107. /**
  108. * Address variable `h1` font-size and margin within `section` and `article`
  109. * contexts in Firefox 4+, Safari, and Chrome.
  110. */
  111. h1 {
  112. font-size: 2em;
  113. margin: 0.67em 0; }
  114. /**
  115. * Address styling not present in IE 8/9.
  116. */
  117. mark {
  118. background: #ff0;
  119. color: #000; }
  120. /**
  121. * Address inconsistent and variable font size in all browsers.
  122. */
  123. small {
  124. font-size: 80%; }
  125. /**
  126. * Prevent `sub` and `sup` affecting `line-height` in all browsers.
  127. */
  128. sub,
  129. sup {
  130. font-size: 75%;
  131. line-height: 0;
  132. position: relative;
  133. vertical-align: baseline; }
  134. sup {
  135. top: -0.5em; }
  136. sub {
  137. bottom: -0.25em; }
  138. /* Embedded content
  139. ========================================================================== */
  140. /**
  141. * Remove border when inside `a` element in IE 8/9/10.
  142. */
  143. img {
  144. border: 0; }
  145. /**
  146. * Correct overflow not hidden in IE 9/10/11.
  147. */
  148. svg:not(:root) {
  149. overflow: hidden; }
  150. /* Grouping content
  151. ========================================================================== */
  152. /**
  153. * Address margin not present in IE 8/9 and Safari.
  154. */
  155. figure {
  156. margin: 1em 40px; }
  157. /**
  158. * Address differences between Firefox and other browsers.
  159. */
  160. hr {
  161. -moz-box-sizing: content-box;
  162. box-sizing: content-box;
  163. height: 0; }
  164. /**
  165. * Contain overflow in all browsers.
  166. */
  167. pre {
  168. overflow: auto; }
  169. /**
  170. * Address odd `em`-unit font size rendering in all browsers.
  171. */
  172. code,
  173. kbd,
  174. pre,
  175. samp {
  176. font-family: monospace, monospace;
  177. font-size: 1em; }
  178. /* Forms
  179. ========================================================================== */
  180. /**
  181. * Known limitation: by default, Chrome and Safari on OS X allow very limited
  182. * styling of `select`, unless a `border` property is set.
  183. */
  184. /**
  185. * 1. Correct color not being inherited.
  186. * Known issue: affects color of disabled elements.
  187. * 2. Correct font properties not being inherited.
  188. * 3. Address margins set differently in Firefox 4+, Safari, and Chrome.
  189. */
  190. button,
  191. input,
  192. optgroup,
  193. select,
  194. textarea {
  195. color: inherit;
  196. /* 1 */
  197. font: inherit;
  198. /* 2 */
  199. margin: 0;
  200. /* 3 */ }
  201. /**
  202. * Address `overflow` set to `hidden` in IE 8/9/10/11.
  203. */
  204. button {
  205. overflow: visible; }
  206. /**
  207. * Address inconsistent `text-transform` inheritance for `button` and `select`.
  208. * All other form control elements do not inherit `text-transform` values.
  209. * Correct `button` style inheritance in Firefox, IE 8/9/10/11, and Opera.
  210. * Correct `select` style inheritance in Firefox.
  211. */
  212. button,
  213. select {
  214. text-transform: none; }
  215. /**
  216. * 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio`
  217. * and `video` controls.
  218. * 2. Correct inability to style clickable `input` types in iOS.
  219. * 3. Improve usability and consistency of cursor style between image-type
  220. * `input` and others.
  221. */
  222. button,
  223. html input[type="button"],
  224. input[type="reset"],
  225. input[type="submit"] {
  226. -webkit-appearance: button;
  227. /* 2 */
  228. cursor: pointer;
  229. /* 3 */ }
  230. /**
  231. * Re-set default cursor for disabled elements.
  232. */
  233. button[disabled],
  234. html input[disabled] {
  235. cursor: default; }
  236. /**
  237. * Remove inner padding and border in Firefox 4+.
  238. */
  239. button::-moz-focus-inner,
  240. input::-moz-focus-inner {
  241. border: 0;
  242. padding: 0; }
  243. /**
  244. * Address Firefox 4+ setting `line-height` on `input` using `!important` in
  245. * the UA stylesheet.
  246. */
  247. input {
  248. line-height: normal; }
  249. /**
  250. * It's recommended that you don't attempt to style these elements.
  251. * Firefox's implementation doesn't respect box-sizing, padding, or width.
  252. *
  253. * 1. Address box sizing set to `content-box` in IE 8/9/10.
  254. * 2. Remove excess padding in IE 8/9/10.
  255. */
  256. input[type="checkbox"],
  257. input[type="radio"] {
  258. box-sizing: border-box;
  259. /* 1 */
  260. padding: 0;
  261. /* 2 */ }
  262. /**
  263. * Fix the cursor style for Chrome's increment/decrement buttons. For certain
  264. * `font-size` values of the `input`, it causes the cursor style of the
  265. * decrement button to change from `default` to `text`.
  266. */
  267. input[type="number"]::-webkit-inner-spin-button,
  268. input[type="number"]::-webkit-outer-spin-button {
  269. height: auto; }
  270. /**
  271. * 1. Address `appearance` set to `searchfield` in Safari and Chrome.
  272. * 2. Address `box-sizing` set to `border-box` in Safari and Chrome
  273. * (include `-moz` to future-proof).
  274. */
  275. input[type="search"] {
  276. -webkit-appearance: textfield;
  277. /* 1 */
  278. -moz-box-sizing: content-box;
  279. -webkit-box-sizing: content-box;
  280. /* 2 */
  281. box-sizing: content-box; }
  282. /**
  283. * Remove inner padding and search cancel button in Safari and Chrome on OS X.
  284. * Safari (but not Chrome) clips the cancel button when the search input has
  285. * padding (and `textfield` appearance).
  286. */
  287. input[type="search"]::-webkit-search-cancel-button,
  288. input[type="search"]::-webkit-search-decoration {
  289. -webkit-appearance: none; }
  290. /**
  291. * Define consistent border, margin, and padding.
  292. */
  293. fieldset {
  294. border: 1px solid #c0c0c0;
  295. margin: 0 2px;
  296. padding: 0.35em 0.625em 0.75em; }
  297. /**
  298. * 1. Correct `color` not being inherited in IE 8/9/10/11.
  299. * 2. Remove padding so people aren't caught out if they zero out fieldsets.
  300. */
  301. legend {
  302. border: 0;
  303. /* 1 */
  304. padding: 0;
  305. /* 2 */ }
  306. /**
  307. * Remove default vertical scrollbar in IE 8/9/10/11.
  308. */
  309. textarea {
  310. overflow: auto; }
  311. /**
  312. * Don't inherit the `font-weight` (applied by a rule above).
  313. * NOTE: the default cannot safely be changed in Chrome and Safari on OS X.
  314. */
  315. optgroup {
  316. font-weight: bold; }
  317. /* Tables
  318. ========================================================================== */
  319. /**
  320. * Remove most spacing between table cells.
  321. */
  322. table {
  323. border-collapse: collapse;
  324. border-spacing: 0; }
  325. td,
  326. th {
  327. padding: 0; }
  328. /*
  329. Copyright 2008-2013 Concur Technologies, Inc.
  330. Licensed under the Apache License, Version 2.0 (the "License"); you may
  331. not use this file except in compliance with the License. You may obtain
  332. a copy of the License at
  333. http://www.apache.org/licenses/LICENSE-2.0
  334. Unless required by applicable law or agreed to in writing, software
  335. distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  336. WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
  337. License for the specific language governing permissions and limitations
  338. under the License.
  339. */
  340. .content h1, .content h2, .content h3, .content h4, .content h5, .content h6, html, body {
  341. font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol";
  342. font-size: 14px; }
  343. .content h1, .content h2, .content h3, .content h4, .content h5, .content h6 {
  344. font-weight: bold; }
  345. .content code, .content pre {
  346. font-family: Consolas, Menlo, Monaco, "Lucida Console", "Liberation Mono", "DejaVu Sans Mono", "Bitstream Vera Sans Mono", "Courier New", monospace, serif;
  347. font-size: 12px;
  348. line-height: 1.5; }
  349. .content code {
  350. word-break: break-all;
  351. hyphens: auto; }
  352. @font-face {
  353. font-family: 'slate';
  354. src: url('https://raw.githubusercontent.com/Mermade/shins/master/source/fonts/slate.eot?-syv14m');
  355. src: url('https://raw.githubusercontent.com/Mermade/shins/master/source/fonts/slate.eot?#iefix-syv14m') format("embedded-opentype"), url('https://raw.githubusercontent.com/Mermade/shins/master/source/fonts/slate.woff2?-syv14m') format("woff2"), url('https://raw.githubusercontent.com/Mermade/shins/master/source/fonts/slate.woff?-syv14m') format("woff"), url('https://raw.githubusercontent.com/Mermade/shins/master/source/fonts/slate.ttf?-syv14m') format("truetype"), url('https://raw.githubusercontent.com/Mermade/shins/master/source/fonts/slate.svg?-syv14m#slate') format("svg");
  356. font-weight: normal;
  357. font-style: normal; }
  358. .content aside.warning:before, .content aside.notice:before, .content aside.success:before, .toc-wrapper > .search:before {
  359. font-family: 'slate';
  360. speak: none;
  361. font-style: normal;
  362. font-weight: normal;
  363. font-variant: normal;
  364. text-transform: none;
  365. line-height: 1; }
  366. .content aside.warning:before {
  367. content: "\e600"; }
  368. .content aside.notice:before {
  369. content: "\e602"; }
  370. .content aside.success:before {
  371. content: "\e606"; }
  372. .toc-wrapper > .search:before {
  373. content: "\e607"; }
  374. /*
  375. Copyright 2008-2013 Concur Technologies, Inc.
  376. Licensed under the Apache License, Version 2.0 (the "License"); you may
  377. not use this file except in compliance with the License. You may obtain
  378. a copy of the License at
  379. http://www.apache.org/licenses/LICENSE-2.0
  380. Unless required by applicable law or agreed to in writing, software
  381. distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  382. WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
  383. License for the specific language governing permissions and limitations
  384. under the License.
  385. */
  386. html, body {
  387. color: #333;
  388. padding: 0;
  389. margin: 0;
  390. -webkit-font-smoothing: antialiased;
  391. -moz-osx-font-smoothing: grayscale;
  392. background-color: #F3F7F9;
  393. height: 100%;
  394. -webkit-text-size-adjust: none;
  395. /* Never autoresize text */ }
  396. #toc > ul > li > a > span {
  397. float: right;
  398. background-color: #2484FF;
  399. border-radius: 40px;
  400. width: 20px; }
  401. .toc-wrapper {
  402. transition: left 0.3s ease-in-out;
  403. overflow-y: auto;
  404. overflow-x: hidden;
  405. position: fixed;
  406. z-index: 30;
  407. top: 0;
  408. left: 0;
  409. bottom: 0;
  410. width: 230px;
  411. background-color: #2E3336;
  412. font-size: 13px;
  413. font-weight: bold; }
  414. .toc-wrapper .lang-selector {
  415. display: none; }
  416. .toc-wrapper .lang-selector a {
  417. padding-top: 0.5em;
  418. padding-bottom: 0.5em; }
  419. .toc-wrapper .logo {
  420. display: block;
  421. max-width: 100%;
  422. margin-bottom: 0px; }
  423. .toc-wrapper > .search {
  424. position: relative; }
  425. .toc-wrapper > .search input {
  426. background: #2E3336;
  427. border-width: 0 0 1px 0;
  428. border-color: #666;
  429. padding: 6px 0 6px 20px;
  430. box-sizing: border-box;
  431. margin: 10px 15px;
  432. width: 200px;
  433. outline: none;
  434. color: #fff;
  435. border-radius: 0;
  436. /* ios has a default border radius */ }
  437. .toc-wrapper > .search:before {
  438. position: absolute;
  439. top: 17px;
  440. left: 15px;
  441. color: #fff; }
  442. .toc-wrapper .search-results {
  443. margin-top: 0;
  444. box-sizing: border-box;
  445. height: 0;
  446. overflow-y: auto;
  447. overflow-x: hidden;
  448. transition-property: height, margin;
  449. transition-duration: 180ms;
  450. transition-timing-function: ease-in-out;
  451. background: #1E2224; }
  452. .toc-wrapper .search-results.visible {
  453. height: 30%;
  454. margin-bottom: 1em; }
  455. .toc-wrapper .search-results li {
  456. margin: 1em 15px;
  457. line-height: 1; }
  458. .toc-wrapper .search-results a {
  459. color: #fff;
  460. text-decoration: none; }
  461. .toc-wrapper .search-results a:hover {
  462. text-decoration: underline; }
  463. .toc-wrapper ul, .toc-wrapper li {
  464. list-style: none;
  465. margin: 0;
  466. padding: 0;
  467. line-height: 28px; }
  468. .toc-wrapper li {
  469. color: #fff;
  470. transition-property: background;
  471. transition-timing-function: linear;
  472. transition-duration: 200ms; }
  473. .toc-wrapper .toc-link.active {
  474. background-color: #0F75D4;
  475. color: #fff; }
  476. .toc-wrapper .toc-link.active-parent {
  477. background-color: #1E2224;
  478. color: #fff; }
  479. .toc-wrapper .toc-list-h2 {
  480. display: none;
  481. background-color: #1E2224;
  482. font-weight: 500; }
  483. .toc-wrapper .toc-h2 {
  484. padding-left: 25px;
  485. font-size: 12px; }
  486. .toc-wrapper .toc-footer {
  487. padding: 1em 0;
  488. margin-top: 1em;
  489. border-top: 1px dashed #666; }
  490. .toc-wrapper .toc-footer li, .toc-wrapper .toc-footer a {
  491. color: #fff;
  492. text-decoration: none; }
  493. .toc-wrapper .toc-footer a:hover {
  494. text-decoration: underline; }
  495. .toc-wrapper .toc-footer li {
  496. font-size: 0.8em;
  497. line-height: 1.7;
  498. text-decoration: none; }
  499. .toc-link, .toc-footer li {
  500. padding: 0 15px 0 15px;
  501. display: block;
  502. overflow-x: hidden;
  503. white-space: nowrap;
  504. text-overflow: ellipsis;
  505. text-decoration: none;
  506. color: #fff;
  507. transition-property: background;
  508. transition-timing-function: linear;
  509. transition-duration: 130ms; }
  510. #nav-button {
  511. padding: 0 1.5em 5em 0;
  512. display: none;
  513. position: fixed;
  514. top: 0;
  515. left: 0;
  516. z-index: 100;
  517. color: #000;
  518. text-decoration: none;
  519. font-weight: bold;
  520. opacity: 0.7;
  521. line-height: 16px;
  522. transition: left 0.3s ease-in-out; }
  523. #nav-button span {
  524. display: block;
  525. padding: 6px 6px 6px;
  526. background-color: rgba(243, 247, 249, 0.7);
  527. transform-origin: 0 0;
  528. transform: rotate(-90deg) translate(-100%, 0);
  529. border-radius: 0 0 0 5px; }
  530. #nav-button img {
  531. height: 16px;
  532. vertical-align: bottom; }
  533. #nav-button:hover {
  534. opacity: 1; }
  535. #nav-button.open {
  536. left: 230px; }
  537. .page-wrapper {
  538. margin-left: 230px;
  539. position: relative;
  540. z-index: 10;
  541. background-color: #F3F7F9;
  542. min-height: 100%;
  543. padding-bottom: 1px; }
  544. .page-wrapper .dark-box {
  545. width: 50%;
  546. background-color: #2E3336;
  547. position: absolute;
  548. right: 0;
  549. top: 0;
  550. bottom: 0; }
  551. .page-wrapper .lang-selector {
  552. position: fixed;
  553. z-index: 50;
  554. border-bottom: 5px solid #2E3336; }
  555. .lang-selector {
  556. background-color: #1E2224;
  557. width: 100%;
  558. font-weight: bold; }
  559. .lang-selector a {
  560. display: block;
  561. float: left;
  562. color: #fff;
  563. text-decoration: none;
  564. padding: 0 10px;
  565. line-height: 30px;
  566. outline: 0; }
  567. .lang-selector a:active, .lang-selector a:focus {
  568. background-color: #111;
  569. color: #fff; }
  570. .lang-selector a.active {
  571. background-color: #2E3336;
  572. color: #fff; }
  573. .lang-selector:after {
  574. content: '';
  575. clear: both;
  576. display: block; }
  577. .content {
  578. -webkit-transform: translateZ(0);
  579. position: relative;
  580. z-index: 30; }
  581. .content:after {
  582. content: '';
  583. display: block;
  584. clear: both; }
  585. .content > h1, .content > h2, .content > h3, .content > h4, .content > h5, .content > h6, .content > p, .content > table, .content > ul, .content > ol, .content > aside, .content > dl {
  586. margin-right: 50%;
  587. padding: 0 28px;
  588. box-sizing: border-box;
  589. display: block; }
  590. .content > ul, .content > ol {
  591. padding-left: 43px; }
  592. .content > h1, .content > h2, .content > div {
  593. clear: both; }
  594. .content h1 {
  595. font-size: 25px;
  596. padding-top: 0.5em;
  597. padding-bottom: 0.5em;
  598. margin-bottom: 21px;
  599. margin-top: 2em;
  600. border-top: 1px solid #ccc;
  601. border-bottom: 1px solid #ccc;
  602. background-color: #fdfdfd; }
  603. .content h1:first-child, .content div:first-child + h1 {
  604. border-top-width: 0;
  605. margin-top: 0; }
  606. .content h2 {
  607. font-size: 19px;
  608. margin-top: 4em;
  609. margin-bottom: 0;
  610. border-top: 1px solid #ccc;
  611. padding-top: 1.2em;
  612. padding-bottom: 1.2em;
  613. background-image: linear-gradient(to bottom, rgba(255, 255, 255, 0.2), rgba(255, 255, 255, 0)); }
  614. .content h1 + h2, .content h1 + div + h2 {
  615. margin-top: -21px;
  616. border-top: none; }
  617. .content h3, .content h4, .content h5, .content h6 {
  618. font-size: 15px;
  619. margin-top: 2.5em;
  620. margin-bottom: 0.8em; }
  621. .content h4, .content h5, .content h6 {
  622. font-size: 10px; }
  623. .content hr {
  624. margin: 2em 0;
  625. border-top: 2px solid #2E3336;
  626. border-bottom: 2px solid #F3F7F9; }
  627. .content table {
  628. margin-bottom: 1em;
  629. overflow: auto; }
  630. .content table th, .content table td {
  631. text-align: left;
  632. vertical-align: top;
  633. line-height: 1.6; }
  634. .content table th code, .content table td code {
  635. white-space: nowrap; }
  636. .content table th {
  637. padding: 5px 10px;
  638. border-bottom: 1px solid #ccc;
  639. vertical-align: bottom; }
  640. .content table td {
  641. padding: 10px; }
  642. .content table tr:last-child {
  643. border-bottom: 1px solid #ccc; }
  644. .content table tr:nth-child(odd) > td {
  645. background-color: white; }
  646. .content table tr:nth-child(even) > td {
  647. background-color: #fbfcfd; }
  648. .content dt {
  649. font-weight: bold; }
  650. .content dd {
  651. margin-left: 15px; }
  652. .content p, .content li, .content dt, .content dd {
  653. line-height: 1.6;
  654. margin-top: 0; }
  655. .content img {
  656. max-width: 100%; }
  657. .content code {
  658. background-color: rgba(0, 0, 0, 0.05);
  659. padding: 3px;
  660. border-radius: 3px; }
  661. .content pre > code {
  662. background-color: transparent;
  663. padding: 0; }
  664. .content aside {
  665. padding-top: 1em;
  666. padding-bottom: 1em;
  667. margin-top: 1.5em;
  668. margin-bottom: 1.5em;
  669. background: #8fbcd4;
  670. line-height: 1.6; }
  671. .content aside.warning {
  672. background-color: #c97a7e; }
  673. .content aside.success {
  674. background-color: #6ac174; }
  675. .content aside:before {
  676. vertical-align: middle;
  677. padding-right: 0.5em;
  678. font-size: 14px; }
  679. .content .search-highlight {
  680. padding: 2px;
  681. margin: -3px;
  682. border-radius: 4px;
  683. border: 1px solid #F7E633;
  684. background: linear-gradient(to top left, #F7E633 0%, #F1D32F 100%); }
  685. .content pre, .content blockquote {
  686. background-color: #1E2224;
  687. color: #fff;
  688. margin: 0;
  689. width: 50%;
  690. float: right;
  691. clear: right;
  692. box-sizing: border-box; }
  693. .content pre > p, .content blockquote > p {
  694. margin: 0; }
  695. .content pre a, .content blockquote a {
  696. color: #fff;
  697. text-decoration: none;
  698. border-bottom: dashed 1px #ccc; }
  699. .content pre {
  700. padding-top: 2em;
  701. padding-bottom: 2em;
  702. padding: 2em 28px; }
  703. .content blockquote > p {
  704. background-color: #191D1F;
  705. padding: 13px 2em;
  706. color: #eee; }
  707. @media (max-width: 930px) {
  708. .toc-wrapper {
  709. left: -230px; }
  710. .toc-wrapper.open {
  711. left: 0; }
  712. .page-wrapper {
  713. margin-left: 0; }
  714. #nav-button {
  715. display: block; }
  716. .toc-link {
  717. padding-top: 0.3em;
  718. padding-bottom: 0.3em; } }
  719. @media (max-width: 700px) {
  720. .dark-box {
  721. display: none; }
  722. .content > h1, .content > h2, .content > h3, .content > h4, .content > h5, .content > h6, .content > p, .content > table, .content > ul, .content > ol, .content > aside, .content > dl {
  723. margin-right: 0; }
  724. .toc-wrapper .lang-selector {
  725. display: block; }
  726. .page-wrapper .lang-selector {
  727. display: none; }
  728. .content pre, .content blockquote {
  729. width: auto;
  730. float: none; }
  731. .content > pre + h1, .content > blockquote + h1, .content > pre + h2, .content > blockquote + h2, .content > pre + h3, .content > blockquote + h3, .content > pre + h4, .content > blockquote + h4, .content > pre + h5, .content > blockquote + h5, .content > pre + h6, .content > blockquote + h6, .content > pre + p, .content > blockquote + p, .content > pre + table, .content > blockquote + table, .content > pre + ul, .content > blockquote + ul, .content > pre + ol, .content > blockquote + ol, .content > pre + aside, .content > blockquote + aside, .content > pre + dl, .content > blockquote + dl {
  732. margin-top: 28px; } }
  733. .highlight .c, .highlight .cm, .highlight .c1, .highlight .cs {
  734. color: #909090; }
  735. .highlight, .highlight .w {
  736. background-color: #1E2224; }
  737. </style>
  738. <style media="print">/*! normalize.css v3.0.2 | MIT License | git.io/normalize */
  739. /**
  740. * 1. Set default font family to sans-serif.
  741. * 2. Prevent iOS text size adjust after orientation change, without disabling
  742. * user zoom.
  743. */
  744. html {
  745. font-family: sans-serif;
  746. /* 1 */
  747. -ms-text-size-adjust: 100%;
  748. /* 2 */
  749. -webkit-text-size-adjust: 100%;
  750. /* 2 */ }
  751. /**
  752. * Remove default margin.
  753. */
  754. body {
  755. margin: 0; }
  756. /* HTML5 display definitions
  757. ========================================================================== */
  758. /**
  759. * Correct `block` display not defined for any HTML5 element in IE 8/9.
  760. * Correct `block` display not defined for `details` or `summary` in IE 10/11
  761. * and Firefox.
  762. * Correct `block` display not defined for `main` in IE 11.
  763. */
  764. article,
  765. aside,
  766. details,
  767. figcaption,
  768. figure,
  769. footer,
  770. header,
  771. hgroup,
  772. main,
  773. menu,
  774. nav,
  775. section,
  776. summary {
  777. display: block; }
  778. /**
  779. * 1. Correct `inline-block` display not defined in IE 8/9.
  780. * 2. Normalize vertical alignment of `progress` in Chrome, Firefox, and Opera.
  781. */
  782. audio,
  783. canvas,
  784. progress,
  785. video {
  786. display: inline-block;
  787. /* 1 */
  788. vertical-align: baseline;
  789. /* 2 */ }
  790. /**
  791. * Prevent modern browsers from displaying `audio` without controls.
  792. * Remove excess height in iOS 5 devices.
  793. */
  794. audio:not([controls]) {
  795. display: none;
  796. height: 0; }
  797. /**
  798. * Address `[hidden]` styling not present in IE 8/9/10.
  799. * Hide the `template` element in IE 8/9/11, Safari, and Firefox < 22.
  800. */
  801. [hidden],
  802. template {
  803. display: none; }
  804. /* Links
  805. ========================================================================== */
  806. /**
  807. * Remove the gray background color from active links in IE 10.
  808. */
  809. a {
  810. background-color: transparent; }
  811. /**
  812. * Improve readability when focused and also mouse hovered in all browsers.
  813. */
  814. a:active,
  815. a:hover {
  816. outline: 0; }
  817. /* Text-level semantics
  818. ========================================================================== */
  819. /**
  820. * Address styling not present in IE 8/9/10/11, Safari, and Chrome.
  821. */
  822. abbr[title] {
  823. border-bottom: 1px dotted; }
  824. /**
  825. * Address style set to `bolder` in Firefox 4+, Safari, and Chrome.
  826. */
  827. b,
  828. strong {
  829. font-weight: bold; }
  830. /**
  831. * Address styling not present in Safari and Chrome.
  832. */
  833. dfn {
  834. font-style: italic; }
  835. /**
  836. * Address variable `h1` font-size and margin within `section` and `article`
  837. * contexts in Firefox 4+, Safari, and Chrome.
  838. */
  839. h1 {
  840. font-size: 2em;
  841. margin: 0.67em 0; }
  842. /**
  843. * Address styling not present in IE 8/9.
  844. */
  845. mark {
  846. background: #ff0;
  847. color: #000; }
  848. /**
  849. * Address inconsistent and variable font size in all browsers.
  850. */
  851. small {
  852. font-size: 80%; }
  853. /**
  854. * Prevent `sub` and `sup` affecting `line-height` in all browsers.
  855. */
  856. sub,
  857. sup {
  858. font-size: 75%;
  859. line-height: 0;
  860. position: relative;
  861. vertical-align: baseline; }
  862. sup {
  863. top: -0.5em; }
  864. sub {
  865. bottom: -0.25em; }
  866. /* Embedded content
  867. ========================================================================== */
  868. /**
  869. * Remove border when inside `a` element in IE 8/9/10.
  870. */
  871. img {
  872. border: 0; }
  873. /**
  874. * Correct overflow not hidden in IE 9/10/11.
  875. */
  876. svg:not(:root) {
  877. overflow: hidden; }
  878. /* Grouping content
  879. ========================================================================== */
  880. /**
  881. * Address margin not present in IE 8/9 and Safari.
  882. */
  883. figure {
  884. margin: 1em 40px; }
  885. /**
  886. * Address differences between Firefox and other browsers.
  887. */
  888. hr {
  889. -moz-box-sizing: content-box;
  890. box-sizing: content-box;
  891. height: 0; }
  892. /**
  893. * Contain overflow in all browsers.
  894. */
  895. pre {
  896. overflow: auto; }
  897. /**
  898. * Address odd `em`-unit font size rendering in all browsers.
  899. */
  900. code,
  901. kbd,
  902. pre,
  903. samp {
  904. font-family: monospace, monospace;
  905. font-size: 1em; }
  906. /* Forms
  907. ========================================================================== */
  908. /**
  909. * Known limitation: by default, Chrome and Safari on OS X allow very limited
  910. * styling of `select`, unless a `border` property is set.
  911. */
  912. /**
  913. * 1. Correct color not being inherited.
  914. * Known issue: affects color of disabled elements.
  915. * 2. Correct font properties not being inherited.
  916. * 3. Address margins set differently in Firefox 4+, Safari, and Chrome.
  917. */
  918. button,
  919. input,
  920. optgroup,
  921. select,
  922. textarea {
  923. color: inherit;
  924. /* 1 */
  925. font: inherit;
  926. /* 2 */
  927. margin: 0;
  928. /* 3 */ }
  929. /**
  930. * Address `overflow` set to `hidden` in IE 8/9/10/11.
  931. */
  932. button {
  933. overflow: visible; }
  934. /**
  935. * Address inconsistent `text-transform` inheritance for `button` and `select`.
  936. * All other form control elements do not inherit `text-transform` values.
  937. * Correct `button` style inheritance in Firefox, IE 8/9/10/11, and Opera.
  938. * Correct `select` style inheritance in Firefox.
  939. */
  940. button,
  941. select {
  942. text-transform: none; }
  943. /**
  944. * 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio`
  945. * and `video` controls.
  946. * 2. Correct inability to style clickable `input` types in iOS.
  947. * 3. Improve usability and consistency of cursor style between image-type
  948. * `input` and others.
  949. */
  950. button,
  951. html input[type="button"],
  952. input[type="reset"],
  953. input[type="submit"] {
  954. -webkit-appearance: button;
  955. /* 2 */
  956. cursor: pointer;
  957. /* 3 */ }
  958. /**
  959. * Re-set default cursor for disabled elements.
  960. */
  961. button[disabled],
  962. html input[disabled] {
  963. cursor: default; }
  964. /**
  965. * Remove inner padding and border in Firefox 4+.
  966. */
  967. button::-moz-focus-inner,
  968. input::-moz-focus-inner {
  969. border: 0;
  970. padding: 0; }
  971. /**
  972. * Address Firefox 4+ setting `line-height` on `input` using `!important` in
  973. * the UA stylesheet.
  974. */
  975. input {
  976. line-height: normal; }
  977. /**
  978. * It's recommended that you don't attempt to style these elements.
  979. * Firefox's implementation doesn't respect box-sizing, padding, or width.
  980. *
  981. * 1. Address box sizing set to `content-box` in IE 8/9/10.
  982. * 2. Remove excess padding in IE 8/9/10.
  983. */
  984. input[type="checkbox"],
  985. input[type="radio"] {
  986. box-sizing: border-box;
  987. /* 1 */
  988. padding: 0;
  989. /* 2 */ }
  990. /**
  991. * Fix the cursor style for Chrome's increment/decrement buttons. For certain
  992. * `font-size` values of the `input`, it causes the cursor style of the
  993. * decrement button to change from `default` to `text`.
  994. */
  995. input[type="number"]::-webkit-inner-spin-button,
  996. input[type="number"]::-webkit-outer-spin-button {
  997. height: auto; }
  998. /**
  999. * 1. Address `appearance` set to `searchfield` in Safari and Chrome.
  1000. * 2. Address `box-sizing` set to `border-box` in Safari and Chrome
  1001. * (include `-moz` to future-proof).
  1002. */
  1003. input[type="search"] {
  1004. -webkit-appearance: textfield;
  1005. /* 1 */
  1006. -moz-box-sizing: content-box;
  1007. -webkit-box-sizing: content-box;
  1008. /* 2 */
  1009. box-sizing: content-box; }
  1010. /**
  1011. * Remove inner padding and search cancel button in Safari and Chrome on OS X.
  1012. * Safari (but not Chrome) clips the cancel button when the search input has
  1013. * padding (and `textfield` appearance).
  1014. */
  1015. input[type="search"]::-webkit-search-cancel-button,
  1016. input[type="search"]::-webkit-search-decoration {
  1017. -webkit-appearance: none; }
  1018. /**
  1019. * Define consistent border, margin, and padding.
  1020. */
  1021. fieldset {
  1022. border: 1px solid #c0c0c0;
  1023. margin: 0 2px;
  1024. padding: 0.35em 0.625em 0.75em; }
  1025. /**
  1026. * 1. Correct `color` not being inherited in IE 8/9/10/11.
  1027. * 2. Remove padding so people aren't caught out if they zero out fieldsets.
  1028. */
  1029. legend {
  1030. border: 0;
  1031. /* 1 */
  1032. padding: 0;
  1033. /* 2 */ }
  1034. /**
  1035. * Remove default vertical scrollbar in IE 8/9/10/11.
  1036. */
  1037. textarea {
  1038. overflow: auto; }
  1039. /**
  1040. * Don't inherit the `font-weight` (applied by a rule above).
  1041. * NOTE: the default cannot safely be changed in Chrome and Safari on OS X.
  1042. */
  1043. optgroup {
  1044. font-weight: bold; }
  1045. /* Tables
  1046. ========================================================================== */
  1047. /**
  1048. * Remove most spacing between table cells.
  1049. */
  1050. table {
  1051. border-collapse: collapse;
  1052. border-spacing: 0; }
  1053. td,
  1054. th {
  1055. padding: 0; }
  1056. /*
  1057. Copyright 2008-2013 Concur Technologies, Inc.
  1058. Licensed under the Apache License, Version 2.0 (the "License"); you may
  1059. not use this file except in compliance with the License. You may obtain
  1060. a copy of the License at
  1061. http://www.apache.org/licenses/LICENSE-2.0
  1062. Unless required by applicable law or agreed to in writing, software
  1063. distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  1064. WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
  1065. License for the specific language governing permissions and limitations
  1066. under the License.
  1067. */
  1068. .content h1, .content h2, .content h3, .content h4, body {
  1069. font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol";
  1070. font-size: 14px; }
  1071. .content h1, .content h2, .content h3, .content h4 {
  1072. font-weight: bold; }
  1073. .content pre, .content code {
  1074. font-family: Consolas, Menlo, Monaco, "Lucida Console", "Liberation Mono", "DejaVu Sans Mono", "Bitstream Vera Sans Mono", "Courier New", monospace, serif;
  1075. font-size: 12px;
  1076. line-height: 1.5; }
  1077. .content pre, .content code {
  1078. word-break: break-all;
  1079. hyphens: auto; }
  1080. @font-face {
  1081. font-family: 'slate';
  1082. src: url('https://raw.githubusercontent.com/Mermade/shins/master/source/fonts/slate.eot?-syv14m');
  1083. src: url('https://raw.githubusercontent.com/Mermade/shins/master/source/fonts/slate.eot?#iefix-syv14m') format("embedded-opentype"), url('https://raw.githubusercontent.com/Mermade/shins/master/source/fonts/slate.woff2?-syv14m') format("woff2"), url('https://raw.githubusercontent.com/Mermade/shins/master/source/fonts/slate.woff?-syv14m') format("woff"), url('https://raw.githubusercontent.com/Mermade/shins/master/source/fonts/slate.ttf?-syv14m') format("truetype"), url('https://raw.githubusercontent.com/Mermade/shins/master/source/fonts/slate.svg?-syv14m#slate') format("svg");
  1084. font-weight: normal;
  1085. font-style: normal; }
  1086. .content aside.warning:before, .content aside.notice:before, .content aside.success:before {
  1087. font-family: 'slate';
  1088. speak: none;
  1089. font-style: normal;
  1090. font-weight: normal;
  1091. font-variant: normal;
  1092. text-transform: none;
  1093. line-height: 1; }
  1094. .content aside.warning:before {
  1095. content: "\e600"; }
  1096. .content aside.notice:before {
  1097. content: "\e602"; }
  1098. .content aside.success:before {
  1099. content: "\e606"; }
  1100. /*
  1101. Copyright 2008-2013 Concur Technologies, Inc.
  1102. Licensed under the Apache License, Version 2.0 (the "License"); you may
  1103. not use this file except in compliance with the License. You may obtain
  1104. a copy of the License at
  1105. http://www.apache.org/licenses/LICENSE-2.0
  1106. Unless required by applicable law or agreed to in writing, software
  1107. distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  1108. WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
  1109. License for the specific language governing permissions and limitations
  1110. under the License.
  1111. */
  1112. .tocify, .toc-footer, .lang-selector, .search, #nav-button {
  1113. display: none; }
  1114. .tocify-wrapper > img {
  1115. margin: 0 auto;
  1116. display: block; }
  1117. .content {
  1118. font-size: 12px; }
  1119. .content pre, .content code {
  1120. border: 1px solid #999;
  1121. border-radius: 5px;
  1122. font-size: 0.8em; }
  1123. .content pre code {
  1124. border: 0; }
  1125. .content pre {
  1126. padding: 1.3em; }
  1127. .content code {
  1128. padding: 0.2em; }
  1129. .content table {
  1130. border: 1px solid #999; }
  1131. .content table tr {
  1132. border-bottom: 1px solid #999; }
  1133. .content table td, .content table th {
  1134. padding: 0.7em; }
  1135. .content p {
  1136. line-height: 1.5; }
  1137. .content a {
  1138. text-decoration: none;
  1139. color: #000; }
  1140. .content h1 {
  1141. font-size: 2.5em;
  1142. padding-top: 0.5em;
  1143. padding-bottom: 0.5em;
  1144. margin-top: 1em;
  1145. margin-bottom: 21px;
  1146. border: 2px solid #ccc;
  1147. border-width: 2px 0;
  1148. text-align: center; }
  1149. .content h2 {
  1150. font-size: 1.8em;
  1151. margin-top: 2em;
  1152. border-top: 2px solid #ccc;
  1153. padding-top: 0.8em; }
  1154. .content h1 + h2, .content h1 + div + h2 {
  1155. border-top: none;
  1156. padding-top: 0;
  1157. margin-top: 0; }
  1158. .content h3, .content h4 {
  1159. font-size: 0.8em;
  1160. margin-top: 1.5em;
  1161. margin-bottom: 0.8em;
  1162. text-transform: uppercase; }
  1163. .content h5, .content h6 {
  1164. text-transform: uppercase; }
  1165. .content aside {
  1166. padding: 1em;
  1167. border: 1px solid #ccc;
  1168. border-radius: 5px;
  1169. margin-top: 1.5em;
  1170. margin-bottom: 1.5em;
  1171. line-height: 1.6; }
  1172. .content aside:before {
  1173. vertical-align: middle;
  1174. padding-right: 0.5em;
  1175. font-size: 14px; }
  1176. </style>
  1177. <style media="screen">/*
  1178. Darkula color scheme from the JetBrains family of IDEs
  1179. */
  1180. .hljs {
  1181. display: block;
  1182. overflow-x: auto;
  1183. padding: 0.5em;
  1184. background: #2b2b2b;
  1185. -webkit-text-size-adjust: none;
  1186. }
  1187. .hljs,
  1188. .hljs-tag,
  1189. .hljs-title,
  1190. .css .hljs-rule,
  1191. .css .hljs-value,
  1192. .aspectj .hljs-function,
  1193. .css .hljs-function .hljs-preprocessor,
  1194. .hljs-pragma {
  1195. color: #bababa;
  1196. }
  1197. .hljs-strongemphasis,
  1198. .hljs-strong,
  1199. .hljs-emphasis {
  1200. color: #a8a8a2;
  1201. }
  1202. .hljs-bullet,
  1203. .hljs-blockquote,
  1204. .hljs-horizontal_rule,
  1205. .hljs-number,
  1206. .hljs-regexp,
  1207. .alias .hljs-keyword,
  1208. .hljs-literal,
  1209. .hljs-hexcolor {
  1210. color: #6896ba;
  1211. }
  1212. .hljs-tag .hljs-value,
  1213. .hljs-code,
  1214. .css .hljs-class,
  1215. .hljs-class .hljs-title:last-child {
  1216. color: #a6e22e;
  1217. }
  1218. .hljs-link_url {
  1219. font-size: 80%;
  1220. }
  1221. .hljs-emphasis,
  1222. .hljs-strongemphasis,
  1223. .hljs-class .hljs-title:last-child,
  1224. .hljs-typename {
  1225. font-style: italic;
  1226. }
  1227. .hljs-keyword,
  1228. .ruby .hljs-class .hljs-keyword:first-child,
  1229. .ruby .hljs-function .hljs-keyword,
  1230. .hljs-function,
  1231. .hljs-change,
  1232. .hljs-winutils,
  1233. .hljs-flow,
  1234. .nginx .hljs-title,
  1235. .tex .hljs-special,
  1236. .hljs-header,
  1237. .hljs-attribute,
  1238. .hljs-symbol,
  1239. .hljs-symbol .hljs-string,
  1240. .hljs-tag .hljs-title,
  1241. .hljs-value,
  1242. .alias .hljs-keyword:first-child,
  1243. .css .hljs-tag,
  1244. .css .unit,
  1245. .css .hljs-important {
  1246. color: #cb7832;
  1247. }
  1248. .hljs-function .hljs-keyword,
  1249. .hljs-class .hljs-keyword:first-child,
  1250. .hljs-aspect .hljs-keyword:first-child,
  1251. .hljs-constant,
  1252. .hljs-typename,
  1253. .css .hljs-attribute {
  1254. color: #cb7832;
  1255. }
  1256. .hljs-variable,
  1257. .hljs-params,
  1258. .hljs-class .hljs-title,
  1259. .hljs-aspect .hljs-title {
  1260. color: #b9b9b9;
  1261. }
  1262. .hljs-string,
  1263. .css .hljs-id,
  1264. .hljs-subst,
  1265. .hljs-type,
  1266. .ruby .hljs-class .hljs-parent,
  1267. .hljs-built_in,
  1268. .django .hljs-template_tag,
  1269. .django .hljs-variable,
  1270. .smalltalk .hljs-class,
  1271. .django .hljs-filter .hljs-argument,
  1272. .smalltalk .hljs-localvars,
  1273. .smalltalk .hljs-array,
  1274. .hljs-attr_selector,
  1275. .hljs-pseudo,
  1276. .hljs-addition,
  1277. .hljs-stream,
  1278. .hljs-envvar,
  1279. .apache .hljs-tag,
  1280. .apache .hljs-cbracket,
  1281. .tex .hljs-command,
  1282. .hljs-prompt,
  1283. .hljs-link_label,
  1284. .hljs-link_url,
  1285. .hljs-name {
  1286. color: #e0c46c;
  1287. }
  1288. .hljs-comment,
  1289. .hljs-annotation,
  1290. .hljs-pi,
  1291. .hljs-doctype,
  1292. .hljs-deletion,
  1293. .hljs-shebang,
  1294. .apache .hljs-sqbracket,
  1295. .tex .hljs-formula {
  1296. color: #7f7f7f;
  1297. }
  1298. .hljs-decorator {
  1299. color: #bab429;
  1300. }
  1301. .coffeescript .javascript,
  1302. .javascript .xml,
  1303. .tex .hljs-formula,
  1304. .xml .javascript,
  1305. .xml .vbscript,
  1306. .xml .css,
  1307. .xml .hljs-cdata,
  1308. .xml .php,
  1309. .php .xml {
  1310. opacity: 0.5;
  1311. }
  1312. </style>
  1313. <script>!function(e,t){"use strict";"object"==typeof module&&"object"==typeof module.exports?module.exports=e.document?t(e,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return t(e)}:t(e)}("undefined"!=typeof window?window:this,function(e,t){"use strict";function n(e,t){t=t||ne;var n=t.createElement("script");n.text=e,t.head.appendChild(n).parentNode.removeChild(n)}function r(e){var t=!!e&&"length"in e&&e.length,n=he.type(e);return"function"!==n&&!he.isWindow(e)&&("array"===n||0===t||"number"==typeof t&&t>0&&t-1 in e)}function i(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()}function o(e,t,n){return he.isFunction(t)?he.grep(e,function(e,r){return!!t.call(e,r,e)!==n}):t.nodeType?he.grep(e,function(e){return e===t!==n}):"string"!=typeof t?he.grep(e,function(e){return ae.call(t,e)>-1!==n}):Ee.test(t)?he.filter(t,e,n):(t=he.filter(t,e),he.grep(e,function(e){return ae.call(t,e)>-1!==n&&1===e.nodeType}))}function s(e,t){for(;(e=e[t])&&1!==e.nodeType;);return e}function a(e){var t={};return he.each(e.match(Ae)||[],function(e,n){t[n]=!0}),t}function u(e){return e}function c(e){throw e}function l(e,t,n,r){var i;try{e&&he.isFunction(i=e.promise)?i.call(e).done(t).fail(n):e&&he.isFunction(i=e.then)?i.call(e,t,n):t.apply(void 0,[e].slice(r))}catch(e){n.apply(void 0,[e])}}function f(){ne.removeEventListener("DOMContentLoaded",f),e.removeEventListener("load",f),he.ready()}function d(){this.expando=he.expando+d.uid++}function p(e){return"true"===e||"false"!==e&&("null"===e?null:e===+e+""?+e:Pe.test(e)?JSON.parse(e):e)}function h(e,t,n){var r;if(void 0===n&&1===e.nodeType)if(r="data-"+t.replace(He,"-$&").toLowerCase(),"string"==typeof(n=e.getAttribute(r))){try{n=p(n)}catch(e){}$e.set(e,t,n)}else n=void 0;return n}function g(e,t,n,r){var i,o=1,s=20,a=r?function(){return r.cur()}:function(){return he.css(e,t,"")},u=a(),c=n&&n[3]||(he.cssNumber[t]?"":"px"),l=(he.cssNumber[t]||"px"!==c&&+u)&&Re.exec(he.css(e,t));if(l&&l[3]!==c){c=c||l[3],n=n||[],l=+u||1;do{o=o||".5",l/=o,he.style(e,t,l+c)}while(o!==(o=a()/u)&&1!==o&&--s)}return n&&(l=+l||+u||0,i=n[1]?l+(n[1]+1)*n[2]:+n[2],r&&(r.unit=c,r.start=l,r.end=i)),i}function v(e){var t,n=e.ownerDocument,r=e.nodeName,i=Be[r];return i||(t=n.body.appendChild(n.createElement(r)),i=he.css(t,"display"),t.parentNode.removeChild(t),"none"===i&&(i="block"),Be[r]=i,i)}function m(e,t){for(var n,r,i=[],o=0,s=e.length;o<s;o++)r=e[o],r.style&&(n=r.style.display,t?("none"===n&&(i[o]=Fe.get(r,"display")||null,i[o]||(r.style.display="")),""===r.style.display&&Me(r)&&(i[o]=v(r))):"none"!==n&&(i[o]="none",Fe.set(r,"display",n)));for(o=0;o<s;o++)null!=i[o]&&(e[o].style.display=i[o]);return e}function y(e,t){var n;return n=void 0!==e.getElementsByTagName?e.getElementsByTagName(t||"*"):void 0!==e.querySelectorAll?e.querySelectorAll(t||"*"):[],void 0===t||t&&i(e,t)?he.merge([e],n):n}function x(e,t){for(var n=0,r=e.length;n<r;n++)Fe.set(e[n],"globalEval",!t||Fe.get(t[n],"globalEval"))}function b(e,t,n,r,i){for(var o,s,a,u,c,l,f=t.createDocumentFragment(),d=[],p=0,h=e.length;p<h;p++)if((o=e[p])||0===o)if("object"===he.type(o))he.merge(d,o.nodeType?[o]:o);else if(Qe.test(o)){for(s=s||f.appendChild(t.createElement("div")),a=(Ve.exec(o)||["",""])[1].toLowerCase(),u=Ue[a]||Ue._default,s.innerHTML=u[1]+he.htmlPrefilter(o)+u[2],l=u[0];l--;)s=s.lastChild;he.merge(d,s.childNodes),s=f.firstChild,s.textContent=""}else d.push(t.createTextNode(o));for(f.textContent="",p=0;o=d[p++];)if(r&&he.inArray(o,r)>-1)i&&i.push(o);else if(c=he.contains(o.ownerDocument,o),s=y(f.appendChild(o),"script"),c&&x(s),n)for(l=0;o=s[l++];)Xe.test(o.type||"")&&n.push(o);return f}function w(){return!0}function T(){return!1}function S(){try{return ne.activeElement}catch(e){}}function E(e,t,n,r,i,o){var s,a;if("object"==typeof t){"string"!=typeof n&&(r=r||n,n=void 0);for(a in t)E(e,a,n,r,t[a],o);return e}if(null==r&&null==i?(i=n,r=n=void 0):null==i&&("string"==typeof n?(i=r,r=void 0):(i=r,r=n,n=void 0)),!1===i)i=T;else if(!i)return e;return 1===o&&(s=i,i=function(e){return he().off(e),s.apply(this,arguments)},i.guid=s.guid||(s.guid=he.guid++)),e.each(function(){he.event.add(this,t,i,r,n)})}function C(e,t){return i(e,"table")&&i(11!==t.nodeType?t:t.firstChild,"tr")?he(">tbody",e)[0]||e:e}function k(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function N(e){var t=nt.exec(e.type);return t?e.type=t[1]:e.removeAttribute("type"),e}function j(e,t){var n,r,i,o,s,a,u,c;if(1===t.nodeType){if(Fe.hasData(e)&&(o=Fe.access(e),s=Fe.set(t,o),c=o.events)){delete s.handle,s.events={};for(i in c)for(n=0,r=c[i].length;n<r;n++)he.event.add(t,i,c[i][n])}$e.hasData(e)&&(a=$e.access(e),u=he.extend({},a),$e.set(t,u))}}function A(e,t){var n=t.nodeName.toLowerCase();"input"===n&&ze.test(e.type)?t.checked=e.checked:"input"!==n&&"textarea"!==n||(t.defaultValue=e.defaultValue)}function L(e,t,r,i){t=oe.apply([],t);var o,s,a,u,c,l,f=0,d=e.length,p=d-1,h=t[0],g=he.isFunction(h);if(g||d>1&&"string"==typeof h&&!pe.checkClone&&tt.test(h))return e.each(function(n){var o=e.eq(n);g&&(t[0]=h.call(this,n,o.html())),L(o,t,r,i)});if(d&&(o=b(t,e[0].ownerDocument,!1,e,i),s=o.firstChild,1===o.childNodes.length&&(o=s),s||i)){for(a=he.map(y(o,"script"),k),u=a.length;f<d;f++)c=o,f!==p&&(c=he.clone(c,!0,!0),u&&he.merge(a,y(c,"script"))),r.call(e[f],c,f);if(u)for(l=a[a.length-1].ownerDocument,he.map(a,N),f=0;f<u;f++)c=a[f],Xe.test(c.type||"")&&!Fe.access(c,"globalEval")&&he.contains(l,c)&&(c.src?he._evalUrl&&he._evalUrl(c.src):n(c.textContent.replace(rt,""),l))}return e}function D(e,t,n){for(var r,i=t?he.filter(t,e):e,o=0;null!=(r=i[o]);o++)n||1!==r.nodeType||he.cleanData(y(r)),r.parentNode&&(n&&he.contains(r.ownerDocument,r)&&x(y(r,"script")),r.parentNode.removeChild(r));return e}function O(e,t,n){var r,i,o,s,a=e.style;return n=n||st(e),n&&(s=n.getPropertyValue(t)||n[t],""!==s||he.contains(e.ownerDocument,e)||(s=he.style(e,t)),!pe.pixelMarginRight()&&ot.test(s)&&it.test(t)&&(r=a.width,i=a.minWidth,o=a.maxWidth,a.minWidth=a.maxWidth=a.width=s,s=n.width,a.width=r,a.minWidth=i,a.maxWidth=o)),void 0!==s?s+"":s}function q(e,t){return{get:function(){return e()?void delete this.get:(this.get=t).apply(this,arguments)}}}function F(e){if(e in dt)return e;for(var t=e[0].toUpperCase()+e.slice(1),n=ft.length;n--;)if((e=ft[n]+t)in dt)return e}function $(e){var t=he.cssProps[e];return t||(t=he.cssProps[e]=F(e)||e),t}function P(e,t,n){var r=Re.exec(t);return r?Math.max(0,r[2]-(n||0))+(r[3]||"px"):t}function H(e,t,n,r,i){var o,s=0;for(o=n===(r?"border":"content")?4:"width"===t?1:0;o<4;o+=2)"margin"===n&&(s+=he.css(e,n+_e[o],!0,i)),r?("content"===n&&(s-=he.css(e,"padding"+_e[o],!0,i)),"margin"!==n&&(s-=he.css(e,"border"+_e[o]+"Width",!0,i))):(s+=he.css(e,"padding"+_e[o],!0,i),"padding"!==n&&(s+=he.css(e,"border"+_e[o]+"Width",!0,i)));return s}function I(e,t,n){var r,i=st(e),o=O(e,t,i),s="border-box"===he.css(e,"boxSizing",!1,i);return ot.test(o)?o:(r=s&&(pe.boxSizingReliable()||o===e.style[t]),"auto"===o&&(o=e["offset"+t[0].toUpperCase()+t.slice(1)]),(o=parseFloat(o)||0)+H(e,t,n||(s?"border":"content"),r,i)+"px")}function R(e,t,n,r,i){return new R.prototype.init(e,t,n,r,i)}function _(){ht&&(!1===ne.hidden&&e.requestAnimationFrame?e.requestAnimationFrame(_):e.setTimeout(_,he.fx.interval),he.fx.tick())}function M(){return e.setTimeout(function(){pt=void 0}),pt=he.now()}function W(e,t){var n,r=0,i={height:e};for(t=t?1:0;r<4;r+=2-t)n=_e[r],i["margin"+n]=i["padding"+n]=e;return t&&(i.opacity=i.width=e),i}function B(e,t,n){for(var r,i=(X.tweeners[t]||[]).concat(X.tweeners["*"]),o=0,s=i.length;o<s;o++)if(r=i[o].call(n,t,e))return r}function z(e,t,n){var r,i,o,s,a,u,c,l,f="width"in t||"height"in t,d=this,p={},h=e.style,g=e.nodeType&&Me(e),v=Fe.get(e,"fxshow");n.queue||(s=he._queueHooks(e,"fx"),null==s.unqueued&&(s.unqueued=0,a=s.empty.fire,s.empty.fire=function(){s.unqueued||a()}),s.unqueued++,d.always(function(){d.always(function(){s.unqueued--,he.queue(e,"fx").length||s.empty.fire()})}));for(r in t)if(i=t[r],gt.test(i)){if(delete t[r],o=o||"toggle"===i,i===(g?"hide":"show")){if("show"!==i||!v||void 0===v[r])continue;g=!0}p[r]=v&&v[r]||he.style(e,r)}if((u=!he.isEmptyObject(t))||!he.isEmptyObject(p)){f&&1===e.nodeType&&(n.overflow=[h.overflow,h.overflowX,h.overflowY],c=v&&v.display,null==c&&(c=Fe.get(e,"display")),l=he.css(e,"display"),"none"===l&&(c?l=c:(m([e],!0),c=e.style.display||c,l=he.css(e,"display"),m([e]))),("inline"===l||"inline-block"===l&&null!=c)&&"none"===he.css(e,"float")&&(u||(d.done(function(){h.display=c}),null==c&&(l=h.display,c="none"===l?"":l)),h.display="inline-block")),n.overflow&&(h.overflow="hidden",d.always(function(){h.overflow=n.overflow[0],h.overflowX=n.overflow[1],h.overflowY=n.overflow[2]})),u=!1;for(r in p)u||(v?"hidden"in v&&(g=v.hidden):v=Fe.access(e,"fxshow",{display:c}),o&&(v.hidden=!g),g&&m([e],!0),d.done(function(){g||m([e]),Fe.remove(e,"fxshow");for(r in p)he.style(e,r,p[r])})),u=B(g?v[r]:0,r,d),r in v||(v[r]=u.start,g&&(u.end=u.start,u.start=0))}}function V(e,t){var n,r,i,o,s;for(n in e)if(r=he.camelCase(n),i=t[r],o=e[n],Array.isArray(o)&&(i=o[1],o=e[n]=o[0]),n!==r&&(e[r]=o,delete e[n]),(s=he.cssHooks[r])&&"expand"in s){o=s.expand(o),delete e[r];for(n in o)n in e||(e[n]=o[n],t[n]=i)}else t[r]=i}function X(e,t,n){var r,i,o=0,s=X.prefilters.length,a=he.Deferred().always(function(){delete u.elem}),u=function(){if(i)return!1;for(var t=pt||M(),n=Math.max(0,c.startTime+c.duration-t),r=n/c.duration||0,o=1-r,s=0,u=c.tweens.length;s<u;s++)c.tweens[s].run(o);return a.notifyWith(e,[c,o,n]),o<1&&u?n:(u||a.notifyWith(e,[c,1,0]),a.resolveWith(e,[c]),!1)},c=a.promise({elem:e,props:he.extend({},t),opts:he.extend(!0,{specialEasing:{},easing:he.easing._default},n),originalProperties:t,originalOptions:n,startTime:pt||M(),duration:n.duration,tweens:[],createTween:function(t,n){var r=he.Tween(e,c.opts,t,n,c.opts.specialEasing[t]||c.opts.easing);return c.tweens.push(r),r},stop:function(t){var n=0,r=t?c.tweens.length:0;if(i)return this;for(i=!0;n<r;n++)c.tweens[n].run(1);return t?(a.notifyWith(e,[c,1,0]),a.resolveWith(e,[c,t])):a.rejectWith(e,[c,t]),this}}),l=c.props;for(V(l,c.opts.specialEasing);o<s;o++)if(r=X.prefilters[o].call(c,e,l,c.opts))return he.isFunction(r.stop)&&(he._queueHooks(c.elem,c.opts.queue).stop=he.proxy(r.stop,r)),r;return he.map(l,B,c),he.isFunction(c.opts.start)&&c.opts.start.call(e,c),c.progress(c.opts.progress).done(c.opts.done,c.opts.complete).fail(c.opts.fail).always(c.opts.always),he.fx.timer(he.extend(u,{elem:e,anim:c,queue:c.opts.queue})),c}function U(e){return(e.match(Ae)||[]).join(" ")}function Q(e){return e.getAttribute&&e.getAttribute("class")||""}function Y(e,t,n,r){var i;if(Array.isArray(t))he.each(t,function(t,i){n||kt.test(e)?r(e,i):Y(e+"["+("object"==typeof i&&null!=i?t:"")+"]",i,n,r)});else if(n||"object"!==he.type(t))r(e,t);else for(i in t)Y(e+"["+i+"]",t[i],n,r)}function J(e){return function(t,n){"string"!=typeof t&&(n=t,t="*");var r,i=0,o=t.toLowerCase().match(Ae)||[];if(he.isFunction(n))for(;r=o[i++];)"+"===r[0]?(r=r.slice(1)||"*",(e[r]=e[r]||[]).unshift(n)):(e[r]=e[r]||[]).push(n)}}function G(e,t,n,r){function i(a){var u;return o[a]=!0,he.each(e[a]||[],function(e,a){var c=a(t,n,r);return"string"!=typeof c||s||o[c]?s?!(u=c):void 0:(t.dataTypes.unshift(c),i(c),!1)}),u}var o={},s=e===It;return i(t.dataTypes[0])||!o["*"]&&i("*")}function K(e,t){var n,r,i=he.ajaxSettings.flatOptions||{};for(n in t)void 0!==t[n]&&((i[n]?e:r||(r={}))[n]=t[n]);return r&&he.extend(!0,e,r),e}function Z(e,t,n){for(var r,i,o,s,a=e.contents,u=e.dataTypes;"*"===u[0];)u.shift(),void 0===r&&(r=e.mimeType||t.getResponseHeader("Content-Type"));if(r)for(i in a)if(a[i]&&a[i].test(r)){u.unshift(i);break}if(u[0]in n)o=u[0];else{for(i in n){if(!u[0]||e.converters[i+" "+u[0]]){o=i;break}s||(s=i)}o=o||s}if(o)return o!==u[0]&&u.unshift(o),n[o]}function ee(e,t,n,r){var i,o,s,a,u,c={},l=e.dataTypes.slice();if(l[1])for(s in e.converters)c[s.toLowerCase()]=e.converters[s];for(o=l.shift();o;)if(e.responseFields[o]&&(n[e.responseFields[o]]=t),!u&&r&&e.dataFilter&&(t=e.dataFilter(t,e.dataType)),u=o,o=l.shift())if("*"===o)o=u;else if("*"!==u&&u!==o){if(!(s=c[u+" "+o]||c["* "+o]))for(i in c)if(a=i.split(" "),a[1]===o&&(s=c[u+" "+a[0]]||c["* "+a[0]])){!0===s?s=c[i]:!0!==c[i]&&(o=a[0],l.unshift(a[1]));break}if(!0!==s)if(s&&e.throws)t=s(t);else try{t=s(t)}catch(e){return{state:"parsererror",error:s?e:"No conversion from "+u+" to "+o}}}return{state:"success",data:t}}var te=[],ne=e.document,re=Object.getPrototypeOf,ie=te.slice,oe=te.concat,se=te.push,ae=te.indexOf,ue={},ce=ue.toString,le=ue.hasOwnProperty,fe=le.toString,de=fe.call(Object),pe={},he=function(e,t){return new he.fn.init(e,t)},ge=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g,ve=/^-ms-/,me=/-([a-z])/g,ye=function(e,t){return t.toUpperCase()};he.fn=he.prototype={jquery:"3.2.1",constructor:he,length:0,toArray:function(){return ie.call(this)},get:function(e){return null==e?ie.call(this):e<0?this[e+this.length]:this[e]},pushStack:function(e){var t=he.merge(this.constructor(),e);return t.prevObject=this,t},each:function(e){return he.each(this,e)},map:function(e){return this.pushStack(he.map(this,function(t,n){return e.call(t,n,t)}))},slice:function(){return this.pushStack(ie.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(e){var t=this.length,n=+e+(e<0?t:0);return this.pushStack(n>=0&&n<t?[this[n]]:[])},end:function(){return this.prevObject||this.constructor()},push:se,sort:te.sort,splice:te.splice},he.extend=he.fn.extend=function(){var e,t,n,r,i,o,s=arguments[0]||{},a=1,u=arguments.length,c=!1;for("boolean"==typeof s&&(c=s,s=arguments[a]||{},a++),"object"==typeof s||he.isFunction(s)||(s={}),a===u&&(s=this,a--);a<u;a++)if(null!=(e=arguments[a]))for(t in e)n=s[t],r=e[t],s!==r&&(c&&r&&(he.isPlainObject(r)||(i=Array.isArray(r)))?(i?(i=!1,o=n&&Array.isArray(n)?n:[]):o=n&&he.isPlainObject(n)?n:{},s[t]=he.extend(c,o,r)):void 0!==r&&(s[t]=r));return s},he.extend({expando:"jQuery"+("3.2.1"+Math.random()).replace(/\D/g,""),isReady:!0,error:function(e){throw new Error(e)},noop:function(){},isFunction:function(e){return"function"===he.type(e)},isWindow:function(e){return null!=e&&e===e.window},isNumeric:function(e){var t=he.type(e);return("number"===t||"string"===t)&&!isNaN(e-parseFloat(e))},isPlainObject:function(e){var t,n;return!(!e||"[object Object]"!==ce.call(e))&&(!(t=re(e))||"function"==typeof(n=le.call(t,"constructor")&&t.constructor)&&fe.call(n)===de)},isEmptyObject:function(e){var t;for(t in e)return!1;return!0},type:function(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?ue[ce.call(e)]||"object":typeof e},globalEval:function(e){n(e)},camelCase:function(e){return e.replace(ve,"ms-").replace(me,ye)},each:function(e,t){var n,i=0;if(r(e))for(n=e.length;i<n&&!1!==t.call(e[i],i,e[i]);i++);else for(i in e)if(!1===t.call(e[i],i,e[i]))break;return e},trim:function(e){return null==e?"":(e+"").replace(ge,"")},makeArray:function(e,t){var n=t||[];return null!=e&&(r(Object(e))?he.merge(n,"string"==typeof e?[e]:e):se.call(n,e)),n},inArray:function(e,t,n){return null==t?-1:ae.call(t,e,n)},merge:function(e,t){for(var n=+t.length,r=0,i=e.length;r<n;r++)e[i++]=t[r];return e.length=i,e},grep:function(e,t,n){for(var r=[],i=0,o=e.length,s=!n;i<o;i++)!t(e[i],i)!==s&&r.push(e[i]);return r},map:function(e,t,n){var i,o,s=0,a=[];if(r(e))for(i=e.length;s<i;s++)null!=(o=t(e[s],s,n))&&a.push(o);else for(s in e)null!=(o=t(e[s],s,n))&&a.push(o);return oe.apply([],a)},guid:1,proxy:function(e,t){var n,r,i;if("string"==typeof t&&(n=e[t],t=e,e=n),he.isFunction(e))return r=ie.call(arguments,2),i=function(){return e.apply(t||this,r.concat(ie.call(arguments)))},i.guid=e.guid=e.guid||he.guid++,i},now:Date.now,support:pe}),"function"==typeof Symbol&&(he.fn[Symbol.iterator]=te[Symbol.iterator]),he.each("Boolean Number String Function Array Date RegExp Object Error Symbol".split(" "),function(e,t){ue["[object "+t+"]"]=t.toLowerCase()});var xe=function(e){function t(e,t,n,r){var i,o,s,a,u,l,d,p=t&&t.ownerDocument,h=t?t.nodeType:9;if(n=n||[],"string"!=typeof e||!e||1!==h&&9!==h&&11!==h)return n;if(!r&&((t?t.ownerDocument||t:R)!==D&&L(t),t=t||D,q)){if(11!==h&&(u=ge.exec(e)))if(i=u[1]){if(9===h){if(!(s=t.getElementById(i)))return n;if(s.id===i)return n.push(s),n}else if(p&&(s=p.getElementById(i))&&H(t,s)&&s.id===i)return n.push(s),n}else{if(u[2])return J.apply(n,t.getElementsByTagName(e)),n;if((i=u[3])&&b.getElementsByClassName&&t.getElementsByClassName)return J.apply(n,t.getElementsByClassName(i)),n}if(b.qsa&&!z[e+" "]&&(!F||!F.test(e))){if(1!==h)p=t,d=e;else if("object"!==t.nodeName.toLowerCase()){for((a=t.getAttribute("id"))?a=a.replace(xe,be):t.setAttribute("id",a=I),l=E(e),o=l.length;o--;)l[o]="#"+a+" "+f(l[o]);d=l.join(","),p=ve.test(e)&&c(t.parentNode)||t}if(d)try{return J.apply(n,p.querySelectorAll(d)),n}catch(e){}finally{a===I&&t.removeAttribute("id")}}}return k(e.replace(oe,"$1"),t,n,r)}function n(){function e(n,r){return t.push(n+" ")>w.cacheLength&&delete e[t.shift()],e[n+" "]=r}var t=[];return e}function r(e){return e[I]=!0,e}function i(e){var t=D.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function o(e,t){for(var n=e.split("|"),r=n.length;r--;)w.attrHandle[n[r]]=t}function s(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)for(;n=n.nextSibling;)if(n===t)return-1;return e?1:-1}function a(e){return function(t){return"form"in t?t.parentNode&&!1===t.disabled?"label"in t?"label"in t.parentNode?t.parentNode.disabled===e:t.disabled===e:t.isDisabled===e||t.isDisabled!==!e&&Te(t)===e:t.disabled===e:"label"in t&&t.disabled===e}}function u(e){return r(function(t){return t=+t,r(function(n,r){for(var i,o=e([],n.length,t),s=o.length;s--;)n[i=o[s]]&&(n[i]=!(r[i]=n[i]))})})}function c(e){return e&&void 0!==e.getElementsByTagName&&e}function l(){}function f(e){for(var t=0,n=e.length,r="";t<n;t++)r+=e[t].value;return r}function d(e,t,n){var r=t.dir,i=t.next,o=i||r,s=n&&"parentNode"===o,a=M++;return t.first?function(t,n,i){for(;t=t[r];)if(1===t.nodeType||s)return e(t,n,i);return!1}:function(t,n,u){var c,l,f,d=[_,a];if(u){for(;t=t[r];)if((1===t.nodeType||s)&&e(t,n,u))return!0}else for(;t=t[r];)if(1===t.nodeType||s)if(f=t[I]||(t[I]={}),l=f[t.uniqueID]||(f[t.uniqueID]={}),i&&i===t.nodeName.toLowerCase())t=t[r]||t;else{if((c=l[o])&&c[0]===_&&c[1]===a)return d[2]=c[2];if(l[o]=d,d[2]=e(t,n,u))return!0}return!1}}function p(e){return e.length>1?function(t,n,r){for(var i=e.length;i--;)if(!e[i](t,n,r))return!1;return!0}:e[0]}function h(e,n,r){for(var i=0,o=n.length;i<o;i++)t(e,n[i],r);return r}function g(e,t,n,r,i){for(var o,s=[],a=0,u=e.length,c=null!=t;a<u;a++)(o=e[a])&&(n&&!n(o,r,i)||(s.push(o),c&&t.push(a)));return s}function v(e,t,n,i,o,s){return i&&!i[I]&&(i=v(i)),o&&!o[I]&&(o=v(o,s)),r(function(r,s,a,u){var c,l,f,d=[],p=[],v=s.length,m=r||h(t||"*",a.nodeType?[a]:a,[]),y=!e||!r&&t?m:g(m,d,e,a,u),x=n?o||(r?e:v||i)?[]:s:y;if(n&&n(y,x,a,u),i)for(c=g(x,p),i(c,[],a,u),l=c.length;l--;)(f=c[l])&&(x[p[l]]=!(y[p[l]]=f));if(r){if(o||e){if(o){for(c=[],l=x.length;l--;)(f=x[l])&&c.push(y[l]=f);o(null,x=[],c,u)}for(l=x.length;l--;)(f=x[l])&&(c=o?K(r,f):d[l])>-1&&(r[c]=!(s[c]=f))}}else x=g(x===s?x.splice(v,x.length):x),o?o(null,s,x,u):J.apply(s,x)})}function m(e){for(var t,n,r,i=e.length,o=w.relative[e[0].type],s=o||w.relative[" "],a=o?1:0,u=d(function(e){return e===t},s,!0),c=d(function(e){return K(t,e)>-1},s,!0),l=[function(e,n,r){var i=!o&&(r||n!==N)||((t=n).nodeType?u(e,n,r):c(e,n,r));return t=null,i}];a<i;a++)if(n=w.relative[e[a].type])l=[d(p(l),n)];else{if(n=w.filter[e[a].type].apply(null,e[a].matches),n[I]){for(r=++a;r<i&&!w.relative[e[r].type];r++);return v(a>1&&p(l),a>1&&f(e.slice(0,a-1).concat({value:" "===e[a-2].type?"*":""})).replace(oe,"$1"),n,a<r&&m(e.slice(a,r)),r<i&&m(e=e.slice(r)),r<i&&f(e))}l.push(n)}return p(l)}function y(e,n){var i=n.length>0,o=e.length>0,s=function(r,s,a,u,c){var l,f,d,p=0,h="0",v=r&&[],m=[],y=N,x=r||o&&w.find.TAG("*",c),b=_+=null==y?1:Math.random()||.1,T=x.length;for(c&&(N=s===D||s||c);h!==T&&null!=(l=x[h]);h++){if(o&&l){for(f=0,s||l.ownerDocument===D||(L(l),a=!q);d=e[f++];)if(d(l,s||D,a)){u.push(l);break}c&&(_=b)}i&&((l=!d&&l)&&p--,r&&v.push(l))}if(p+=h,i&&h!==p){for(f=0;d=n[f++];)d(v,m,s,a);if(r){if(p>0)for(;h--;)v[h]||m[h]||(m[h]=Q.call(u));m=g(m)}J.apply(u,m),c&&!r&&m.length>0&&p+n.length>1&&t.uniqueSort(u)}return c&&(_=b,N=y),v};return i?r(s):s}var x,b,w,T,S,E,C,k,N,j,A,L,D,O,q,F,$,P,H,I="sizzle"+1*new Date,R=e.document,_=0,M=0,W=n(),B=n(),z=n(),V=function(e,t){return e===t&&(A=!0),0},X={}.hasOwnProperty,U=[],Q=U.pop,Y=U.push,J=U.push,G=U.slice,K=function(e,t){for(var n=0,r=e.length;n<r;n++)if(e[n]===t)return n;return-1},Z="checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",ee="[\\x20\\t\\r\\n\\f]",te="(?:\\\\.|[\\w-]|[^\0-\\xa0])+",ne="\\["+ee+"*("+te+")(?:"+ee+"*([*^$|!~]?=)"+ee+"*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|("+te+"))|)"+ee+"*\\]",re=":("+te+")(?:\\((('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|((?:\\\\.|[^\\\\()[\\]]|"+ne+")*)|.*)\\)|)",ie=new RegExp(ee+"+","g"),oe=new RegExp("^"+ee+"+|((?:^|[^\\\\])(?:\\\\.)*)"+ee+"+$","g"),se=new RegExp("^"+ee+"*,"+ee+"*"),ae=new RegExp("^"+ee+"*([>+~]|"+ee+")"+ee+"*"),ue=new RegExp("="+ee+"*([^\\]'\"]*?)"+ee+"*\\]","g"),ce=new RegExp(re),le=new RegExp("^"+te+"$"),fe={ID:new RegExp("^#("+te+")"),CLASS:new RegExp("^\\.("+te+")"),TAG:new RegExp("^("+te+"|[*])"),ATTR:new RegExp("^"+ne),PSEUDO:new RegExp("^"+re),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+ee+"*(even|odd|(([+-]|)(\\d*)n|)"+ee+"*(?:([+-]|)"+ee+"*(\\d+)|))"+ee+"*\\)|)","i"),bool:new RegExp("^(?:"+Z+")$","i"),needsContext:new RegExp("^"+ee+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+ee+"*((?:-\\d)?\\d*)"+ee+"*\\)|)(?=[^-]|$)","i")},de=/^(?:input|select|textarea|button)$/i,pe=/^h\d$/i,he=/^[^{]+\{\s*\[native \w/,ge=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,ve=/[+~]/,me=new RegExp("\\\\([\\da-f]{1,6}"+ee+"?|("+ee+")|.)","ig"),ye=function(e,t,n){var r="0x"+t-65536;return r!==r||n?t:r<0?String.fromCharCode(r+65536):String.fromCharCode(r>>10|55296,1023&r|56320)},xe=/([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,be=function(e,t){return t?"\0"===e?"�":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},we=function(){L()},Te=d(function(e){return!0===e.disabled&&("form"in e||"label"in e)},{dir:"parentNode",next:"legend"});try{J.apply(U=G.call(R.childNodes),R.childNodes),U[R.childNodes.length].nodeType}catch(e){J={apply:U.length?function(e,t){Y.apply(e,G.call(t))}:function(e,t){for(var n=e.length,r=0;e[n++]=t[r++];);e.length=n-1}}}b=t.support={},S=t.isXML=function(e){var t=e&&(e.ownerDocument||e).documentElement;return!!t&&"HTML"!==t.nodeName},L=t.setDocument=function(e){var t,n,r=e?e.ownerDocument||e:R;return r!==D&&9===r.nodeType&&r.documentElement?(D=r,O=D.documentElement,q=!S(D),R!==D&&(n=D.defaultView)&&n.top!==n&&(n.addEventListener?n.addEventListener("unload",we,!1):n.attachEvent&&n.attachEvent("onunload",we)),b.attributes=i(function(e){return e.className="i",!e.getAttribute("className")}),b.getElementsByTagName=i(function(e){return e.appendChild(D.createComment("")),!e.getElementsByTagName("*").length}),b.getElementsByClassName=he.test(D.getElementsByClassName),b.getById=i(function(e){return O.appendChild(e).id=I,!D.getElementsByName||!D.getElementsByName(I).length}),b.getById?(w.filter.ID=function(e){var t=e.replace(me,ye);return function(e){return e.getAttribute("id")===t}},w.find.ID=function(e,t){if(void 0!==t.getElementById&&q){var n=t.getElementById(e);return n?[n]:[]}}):(w.filter.ID=function(e){var t=e.replace(me,ye);return function(e){var n=void 0!==e.getAttributeNode&&e.getAttributeNode("id");return n&&n.value===t}},w.find.ID=function(e,t){if(void 0!==t.getElementById&&q){var n,r,i,o=t.getElementById(e);if(o){if((n=o.getAttributeNode("id"))&&n.value===e)return[o];for(i=t.getElementsByName(e),r=0;o=i[r++];)if((n=o.getAttributeNode("id"))&&n.value===e)return[o]}return[]}}),w.find.TAG=b.getElementsByTagName?function(e,t){return void 0!==t.getElementsByTagName?t.getElementsByTagName(e):b.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=[],i=0,o=t.getElementsByTagName(e);if("*"===e){for(;n=o[i++];)1===n.nodeType&&r.push(n);return r}return o},w.find.CLASS=b.getElementsByClassName&&function(e,t){if(void 0!==t.getElementsByClassName&&q)return t.getElementsByClassName(e)},$=[],F=[],(b.qsa=he.test(D.querySelectorAll))&&(i(function(e){O.appendChild(e).innerHTML="<a id='"+I+"'></a><select id='"+I+"-\r\\' msallowcapture=''><option selected=''></option></select>",e.querySelectorAll("[msallowcapture^='']").length&&F.push("[*^$]="+ee+"*(?:''|\"\")"),e.querySelectorAll("[selected]").length||F.push("\\["+ee+"*(?:value|"+Z+")"),e.querySelectorAll("[id~="+I+"-]").length||F.push("~="),e.querySelectorAll(":checked").length||F.push(":checked"),e.querySelectorAll("a#"+I+"+*").length||F.push(".#.+[+~]")}),i(function(e){e.innerHTML="<a href='' disabled='disabled'></a><select disabled='disabled'><option/></select>";var t=D.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("[name=d]").length&&F.push("name"+ee+"*[*^$|!~]?="),2!==e.querySelectorAll(":enabled").length&&F.push(":enabled",":disabled"),O.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&F.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),F.push(",.*:")})),(b.matchesSelector=he.test(P=O.matches||O.webkitMatchesSelector||O.mozMatchesSelector||O.oMatchesSelector||O.msMatchesSelector))&&i(function(e){b.disconnectedMatch=P.call(e,"*"),P.call(e,"[s!='']:x"),$.push("!=",re)}),F=F.length&&new RegExp(F.join("|")),$=$.length&&new RegExp($.join("|")),t=he.test(O.compareDocumentPosition),H=t||he.test(O.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)for(;t=t.parentNode;)if(t===e)return!0;return!1},V=t?function(e,t){if(e===t)return A=!0,0;var n=!e.compareDocumentPosition-!t.compareDocumentPosition;return n||(n=(e.ownerDocument||e)===(t.ownerDocument||t)?e.compareDocumentPosition(t):1,1&n||!b.sortDetached&&t.compareDocumentPosition(e)===n?e===D||e.ownerDocument===R&&H(R,e)?-1:t===D||t.ownerDocument===R&&H(R,t)?1:j?K(j,e)-K(j,t):0:4&n?-1:1)}:function(e,t){if(e===t)return A=!0,0;var n,r=0,i=e.parentNode,o=t.parentNode,a=[e],u=[t];if(!i||!o)return e===D?-1:t===D?1:i?-1:o?1:j?K(j,e)-K(j,t):0;if(i===o)return s(e,t);for(n=e;n=n.parentNode;)a.unshift(n);for(n=t;n=n.parentNode;)u.unshift(n);for(;a[r]===u[r];)r++;return r?s(a[r],u[r]):a[r]===R?-1:u[r]===R?1:0},D):D},t.matches=function(e,n){return t(e,null,null,n)},t.matchesSelector=function(e,n){if((e.ownerDocument||e)!==D&&L(e),n=n.replace(ue,"='$1']"),b.matchesSelector&&q&&!z[n+" "]&&(!$||!$.test(n))&&(!F||!F.test(n)))try{var r=P.call(e,n);if(r||b.disconnectedMatch||e.document&&11!==e.document.nodeType)return r}catch(e){}return t(n,D,null,[e]).length>0},t.contains=function(e,t){return(e.ownerDocument||e)!==D&&L(e),H(e,t)},t.attr=function(e,t){(e.ownerDocument||e)!==D&&L(e);var n=w.attrHandle[t.toLowerCase()],r=n&&X.call(w.attrHandle,t.toLowerCase())?n(e,t,!q):void 0;return void 0!==r?r:b.attributes||!q?e.getAttribute(t):(r=e.getAttributeNode(t))&&r.specified?r.value:null},t.escape=function(e){return(e+"").replace(xe,be)},t.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},t.uniqueSort=function(e){var t,n=[],r=0,i=0;if(A=!b.detectDuplicates,j=!b.sortStable&&e.slice(0),e.sort(V),A){for(;t=e[i++];)t===e[i]&&(r=n.push(i));for(;r--;)e.splice(n[r],1)}return j=null,e},T=t.getText=function(e){var t,n="",r=0,i=e.nodeType;if(i){if(1===i||9===i||11===i){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=T(e)}else if(3===i||4===i)return e.nodeValue}else for(;t=e[r++];)n+=T(t);return n},w=t.selectors={cacheLength:50,createPseudo:r,match:fe,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(me,ye),e[3]=(e[3]||e[4]||e[5]||"").replace(me,ye),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||t.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&t.error(e[0]),e},PSEUDO:function(e){var t,n=!e[6]&&e[2];return fe.CHILD.test(e[0])?null:(e[3]?e[2]=e[4]||e[5]||"":n&&ce.test(n)&&(t=E(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e[0]=e[0].slice(0,t),e[2]=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(me,ye).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=W[e+" "];return t||(t=new RegExp("(^|"+ee+")"+e+"("+ee+"|$)"))&&W(e,function(e){return t.test("string"==typeof e.className&&e.className||void 0!==e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(e,n,r){return function(i){var o=t.attr(i,e);return null==o?"!="===n:!n||(o+="","="===n?o===r:"!="===n?o!==r:"^="===n?r&&0===o.indexOf(r):"*="===n?r&&o.indexOf(r)>-1:"$="===n?r&&o.slice(-r.length)===r:"~="===n?(" "+o.replace(ie," ")+" ").indexOf(r)>-1:"|="===n&&(o===r||o.slice(0,r.length+1)===r+"-"))}},CHILD:function(e,t,n,r,i){var o="nth"!==e.slice(0,3),s="last"!==e.slice(-4),a="of-type"===t;return 1===r&&0===i?function(e){return!!e.parentNode}:function(t,n,u){var c,l,f,d,p,h,g=o!==s?"nextSibling":"previousSibling",v=t.parentNode,m=a&&t.nodeName.toLowerCase(),y=!u&&!a,x=!1;if(v){if(o){for(;g;){for(d=t;d=d[g];)if(a?d.nodeName.toLowerCase()===m:1===d.nodeType)return!1;h=g="only"===e&&!h&&"nextSibling"}return!0}if(h=[s?v.firstChild:v.lastChild],s&&y){for(d=v,f=d[I]||(d[I]={}),l=f[d.uniqueID]||(f[d.uniqueID]={}),c=l[e]||[],p=c[0]===_&&c[1],x=p&&c[2],d=p&&v.childNodes[p];d=++p&&d&&d[g]||(x=p=0)||h.pop();)if(1===d.nodeType&&++x&&d===t){l[e]=[_,p,x];break}}else if(y&&(d=t,f=d[I]||(d[I]={}),l=f[d.uniqueID]||(f[d.uniqueID]={}),c=l[e]||[],p=c[0]===_&&c[1],x=p),!1===x)for(;(d=++p&&d&&d[g]||(x=p=0)||h.pop())&&((a?d.nodeName.toLowerCase()!==m:1!==d.nodeType)||!++x||(y&&(f=d[I]||(d[I]={}),l=f[d.uniqueID]||(f[d.uniqueID]={}),l[e]=[_,x]),d!==t)););return(x-=i)===r||x%r==0&&x/r>=0}}},PSEUDO:function(e,n){var i,o=w.pseudos[e]||w.setFilters[e.toLowerCase()]||t.error("unsupported pseudo: "+e);return o[I]?o(n):o.length>1?(i=[e,e,"",n],w.setFilters.hasOwnProperty(e.toLowerCase())?r(function(e,t){for(var r,i=o(e,n),s=i.length;s--;)r=K(e,i[s]),e[r]=!(t[r]=i[s])}):function(e){return o(e,0,i)}):o}},pseudos:{not:r(function(e){var t=[],n=[],i=C(e.replace(oe,"$1"));return i[I]?r(function(e,t,n,r){for(var o,s=i(e,null,r,[]),a=e.length;a--;)(o=s[a])&&(e[a]=!(t[a]=o))}):function(e,r,o){return t[0]=e,i(t,null,o,n),t[0]=null,!n.pop()}}),has:r(function(e){return function(n){return t(e,n).length>0}}),contains:r(function(e){return e=e.replace(me,ye),function(t){return(t.textContent||t.innerText||T(t)).indexOf(e)>-1}}),lang:r(function(e){return le.test(e||"")||t.error("unsupported lang: "+e),e=e.replace(me,ye).toLowerCase(),function(t){var n;do{if(n=q?t.lang:t.getAttribute("xml:lang")||t.getAttribute("lang"))return(n=n.toLowerCase())===e||0===n.indexOf(e+"-")}while((t=t.parentNode)&&1===t.nodeType);return!1}}),target:function(t){var n=e.location&&e.location.hash;return n&&n.slice(1)===t.id},root:function(e){return e===O},focus:function(e){return e===D.activeElement&&(!D.hasFocus||D.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:a(!1),disabled:a(!0),checked:function(e){var t=e.nodeName.toLowerCase()
  1314. ;return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,!0===e.selected},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeType<6)return!1;return!0},parent:function(e){return!w.pseudos.empty(e)},header:function(e){return pe.test(e.nodeName)},input:function(e){return de.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||"text"===t.toLowerCase())},first:u(function(){return[0]}),last:u(function(e,t){return[t-1]}),eq:u(function(e,t,n){return[n<0?n+t:n]}),even:u(function(e,t){for(var n=0;n<t;n+=2)e.push(n);return e}),odd:u(function(e,t){for(var n=1;n<t;n+=2)e.push(n);return e}),lt:u(function(e,t,n){for(var r=n<0?n+t:n;--r>=0;)e.push(r);return e}),gt:u(function(e,t,n){for(var r=n<0?n+t:n;++r<t;)e.push(r);return e})}},w.pseudos.nth=w.pseudos.eq;for(x in{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})w.pseudos[x]=function(e){return function(t){return"input"===t.nodeName.toLowerCase()&&t.type===e}}(x);for(x in{submit:!0,reset:!0})w.pseudos[x]=function(e){return function(t){var n=t.nodeName.toLowerCase();return("input"===n||"button"===n)&&t.type===e}}(x);return l.prototype=w.filters=w.pseudos,w.setFilters=new l,E=t.tokenize=function(e,n){var r,i,o,s,a,u,c,l=B[e+" "];if(l)return n?0:l.slice(0);for(a=e,u=[],c=w.preFilter;a;){r&&!(i=se.exec(a))||(i&&(a=a.slice(i[0].length)||a),u.push(o=[])),r=!1,(i=ae.exec(a))&&(r=i.shift(),o.push({value:r,type:i[0].replace(oe," ")}),a=a.slice(r.length));for(s in w.filter)!(i=fe[s].exec(a))||c[s]&&!(i=c[s](i))||(r=i.shift(),o.push({value:r,type:s,matches:i}),a=a.slice(r.length));if(!r)break}return n?a.length:a?t.error(e):B(e,u).slice(0)},C=t.compile=function(e,t){var n,r=[],i=[],o=z[e+" "];if(!o){for(t||(t=E(e)),n=t.length;n--;)o=m(t[n]),o[I]?r.push(o):i.push(o);o=z(e,y(i,r)),o.selector=e}return o},k=t.select=function(e,t,n,r){var i,o,s,a,u,l="function"==typeof e&&e,d=!r&&E(e=l.selector||e);if(n=n||[],1===d.length){if(o=d[0]=d[0].slice(0),o.length>2&&"ID"===(s=o[0]).type&&9===t.nodeType&&q&&w.relative[o[1].type]){if(!(t=(w.find.ID(s.matches[0].replace(me,ye),t)||[])[0]))return n;l&&(t=t.parentNode),e=e.slice(o.shift().value.length)}for(i=fe.needsContext.test(e)?0:o.length;i--&&(s=o[i],!w.relative[a=s.type]);)if((u=w.find[a])&&(r=u(s.matches[0].replace(me,ye),ve.test(o[0].type)&&c(t.parentNode)||t))){if(o.splice(i,1),!(e=r.length&&f(o)))return J.apply(n,r),n;break}}return(l||C(e,d))(r,t,!q,n,!t||ve.test(e)&&c(t.parentNode)||t),n},b.sortStable=I.split("").sort(V).join("")===I,b.detectDuplicates=!!A,L(),b.sortDetached=i(function(e){return 1&e.compareDocumentPosition(D.createElement("fieldset"))}),i(function(e){return e.innerHTML="<a href='#'></a>","#"===e.firstChild.getAttribute("href")})||o("type|href|height|width",function(e,t,n){if(!n)return e.getAttribute(t,"type"===t.toLowerCase()?1:2)}),b.attributes&&i(function(e){return e.innerHTML="<input/>",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||o("value",function(e,t,n){if(!n&&"input"===e.nodeName.toLowerCase())return e.defaultValue}),i(function(e){return null==e.getAttribute("disabled")})||o(Z,function(e,t,n){var r;if(!n)return!0===e[t]?t.toLowerCase():(r=e.getAttributeNode(t))&&r.specified?r.value:null}),t}(e);he.find=xe,he.expr=xe.selectors,he.expr[":"]=he.expr.pseudos,he.uniqueSort=he.unique=xe.uniqueSort,he.text=xe.getText,he.isXMLDoc=xe.isXML,he.contains=xe.contains,he.escapeSelector=xe.escape;var be=function(e,t,n){for(var r=[],i=void 0!==n;(e=e[t])&&9!==e.nodeType;)if(1===e.nodeType){if(i&&he(e).is(n))break;r.push(e)}return r},we=function(e,t){for(var n=[];e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n},Te=he.expr.match.needsContext,Se=/^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i,Ee=/^.[^:#\[\.,]*$/;he.filter=function(e,t,n){var r=t[0];return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?he.find.matchesSelector(r,e)?[r]:[]:he.find.matches(e,he.grep(t,function(e){return 1===e.nodeType}))},he.fn.extend({find:function(e){var t,n,r=this.length,i=this;if("string"!=typeof e)return this.pushStack(he(e).filter(function(){for(t=0;t<r;t++)if(he.contains(i[t],this))return!0}));for(n=this.pushStack([]),t=0;t<r;t++)he.find(e,i[t],n);return r>1?he.uniqueSort(n):n},filter:function(e){return this.pushStack(o(this,e||[],!1))},not:function(e){return this.pushStack(o(this,e||[],!0))},is:function(e){return!!o(this,"string"==typeof e&&Te.test(e)?he(e):e||[],!1).length}});var Ce,ke=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/;(he.fn.init=function(e,t,n){var r,i;if(!e)return this;if(n=n||Ce,"string"==typeof e){if(!(r="<"===e[0]&&">"===e[e.length-1]&&e.length>=3?[null,e,null]:ke.exec(e))||!r[1]&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(r[1]){if(t=t instanceof he?t[0]:t,he.merge(this,he.parseHTML(r[1],t&&t.nodeType?t.ownerDocument||t:ne,!0)),Se.test(r[1])&&he.isPlainObject(t))for(r in t)he.isFunction(this[r])?this[r](t[r]):this.attr(r,t[r]);return this}return i=ne.getElementById(r[2]),i&&(this[0]=i,this.length=1),this}return e.nodeType?(this[0]=e,this.length=1,this):he.isFunction(e)?void 0!==n.ready?n.ready(e):e(he):he.makeArray(e,this)}).prototype=he.fn,Ce=he(ne);var Ne=/^(?:parents|prev(?:Until|All))/,je={children:!0,contents:!0,next:!0,prev:!0};he.fn.extend({has:function(e){var t=he(e,this),n=t.length;return this.filter(function(){for(var e=0;e<n;e++)if(he.contains(this,t[e]))return!0})},closest:function(e,t){var n,r=0,i=this.length,o=[],s="string"!=typeof e&&he(e);if(!Te.test(e))for(;r<i;r++)for(n=this[r];n&&n!==t;n=n.parentNode)if(n.nodeType<11&&(s?s.index(n)>-1:1===n.nodeType&&he.find.matchesSelector(n,e))){o.push(n);break}return this.pushStack(o.length>1?he.uniqueSort(o):o)},index:function(e){return e?"string"==typeof e?ae.call(he(e),this[0]):ae.call(this,e.jquery?e[0]:e):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(e,t){return this.pushStack(he.uniqueSort(he.merge(this.get(),he(e,t))))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}}),he.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return be(e,"parentNode")},parentsUntil:function(e,t,n){return be(e,"parentNode",n)},next:function(e){return s(e,"nextSibling")},prev:function(e){return s(e,"previousSibling")},nextAll:function(e){return be(e,"nextSibling")},prevAll:function(e){return be(e,"previousSibling")},nextUntil:function(e,t,n){return be(e,"nextSibling",n)},prevUntil:function(e,t,n){return be(e,"previousSibling",n)},siblings:function(e){return we((e.parentNode||{}).firstChild,e)},children:function(e){return we(e.firstChild)},contents:function(e){return i(e,"iframe")?e.contentDocument:(i(e,"template")&&(e=e.content||e),he.merge([],e.childNodes))}},function(e,t){he.fn[e]=function(n,r){var i=he.map(this,t,n);return"Until"!==e.slice(-5)&&(r=n),r&&"string"==typeof r&&(i=he.filter(r,i)),this.length>1&&(je[e]||he.uniqueSort(i),Ne.test(e)&&i.reverse()),this.pushStack(i)}});var Ae=/[^\x20\t\r\n\f]+/g;he.Callbacks=function(e){e="string"==typeof e?a(e):he.extend({},e);var t,n,r,i,o=[],s=[],u=-1,c=function(){for(i=i||e.once,r=t=!0;s.length;u=-1)for(n=s.shift();++u<o.length;)!1===o[u].apply(n[0],n[1])&&e.stopOnFalse&&(u=o.length,n=!1);e.memory||(n=!1),t=!1,i&&(o=n?[]:"")},l={add:function(){return o&&(n&&!t&&(u=o.length-1,s.push(n)),function t(n){he.each(n,function(n,r){he.isFunction(r)?e.unique&&l.has(r)||o.push(r):r&&r.length&&"string"!==he.type(r)&&t(r)})}(arguments),n&&!t&&c()),this},remove:function(){return he.each(arguments,function(e,t){for(var n;(n=he.inArray(t,o,n))>-1;)o.splice(n,1),n<=u&&u--}),this},has:function(e){return e?he.inArray(e,o)>-1:o.length>0},empty:function(){return o&&(o=[]),this},disable:function(){return i=s=[],o=n="",this},disabled:function(){return!o},lock:function(){return i=s=[],n||t||(o=n=""),this},locked:function(){return!!i},fireWith:function(e,n){return i||(n=n||[],n=[e,n.slice?n.slice():n],s.push(n),t||c()),this},fire:function(){return l.fireWith(this,arguments),this},fired:function(){return!!r}};return l},he.extend({Deferred:function(t){var n=[["notify","progress",he.Callbacks("memory"),he.Callbacks("memory"),2],["resolve","done",he.Callbacks("once memory"),he.Callbacks("once memory"),0,"resolved"],["reject","fail",he.Callbacks("once memory"),he.Callbacks("once memory"),1,"rejected"]],r="pending",i={state:function(){return r},always:function(){return o.done(arguments).fail(arguments),this},catch:function(e){return i.then(null,e)},pipe:function(){var e=arguments;return he.Deferred(function(t){he.each(n,function(n,r){var i=he.isFunction(e[r[4]])&&e[r[4]];o[r[1]](function(){var e=i&&i.apply(this,arguments);e&&he.isFunction(e.promise)?e.promise().progress(t.notify).done(t.resolve).fail(t.reject):t[r[0]+"With"](this,i?[e]:arguments)})}),e=null}).promise()},then:function(t,r,i){function o(t,n,r,i){return function(){var a=this,l=arguments,f=function(){var e,f;if(!(t<s)){if((e=r.apply(a,l))===n.promise())throw new TypeError("Thenable self-resolution");f=e&&("object"==typeof e||"function"==typeof e)&&e.then,he.isFunction(f)?i?f.call(e,o(s,n,u,i),o(s,n,c,i)):(s++,f.call(e,o(s,n,u,i),o(s,n,c,i),o(s,n,u,n.notifyWith))):(r!==u&&(a=void 0,l=[e]),(i||n.resolveWith)(a,l))}},d=i?f:function(){try{f()}catch(e){he.Deferred.exceptionHook&&he.Deferred.exceptionHook(e,d.stackTrace),t+1>=s&&(r!==c&&(a=void 0,l=[e]),n.rejectWith(a,l))}};t?d():(he.Deferred.getStackHook&&(d.stackTrace=he.Deferred.getStackHook()),e.setTimeout(d))}}var s=0;return he.Deferred(function(e){n[0][3].add(o(0,e,he.isFunction(i)?i:u,e.notifyWith)),n[1][3].add(o(0,e,he.isFunction(t)?t:u)),n[2][3].add(o(0,e,he.isFunction(r)?r:c))}).promise()},promise:function(e){return null!=e?he.extend(e,i):i}},o={};return he.each(n,function(e,t){var s=t[2],a=t[5];i[t[1]]=s.add,a&&s.add(function(){r=a},n[3-e][2].disable,n[0][2].lock),s.add(t[3].fire),o[t[0]]=function(){return o[t[0]+"With"](this===o?void 0:this,arguments),this},o[t[0]+"With"]=s.fireWith}),i.promise(o),t&&t.call(o,o),o},when:function(e){var t=arguments.length,n=t,r=Array(n),i=ie.call(arguments),o=he.Deferred(),s=function(e){return function(n){r[e]=this,i[e]=arguments.length>1?ie.call(arguments):n,--t||o.resolveWith(r,i)}};if(t<=1&&(l(e,o.done(s(n)).resolve,o.reject,!t),"pending"===o.state()||he.isFunction(i[n]&&i[n].then)))return o.then();for(;n--;)l(i[n],s(n),o.reject);return o.promise()}});var Le=/^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;he.Deferred.exceptionHook=function(t,n){e.console&&e.console.warn&&t&&Le.test(t.name)&&e.console.warn("jQuery.Deferred exception: "+t.message,t.stack,n)},he.readyException=function(t){e.setTimeout(function(){throw t})};var De=he.Deferred();he.fn.ready=function(e){return De.then(e).catch(function(e){he.readyException(e)}),this},he.extend({isReady:!1,readyWait:1,ready:function(e){(!0===e?--he.readyWait:he.isReady)||(he.isReady=!0,!0!==e&&--he.readyWait>0||De.resolveWith(ne,[he]))}}),he.ready.then=De.then,"complete"===ne.readyState||"loading"!==ne.readyState&&!ne.documentElement.doScroll?e.setTimeout(he.ready):(ne.addEventListener("DOMContentLoaded",f),e.addEventListener("load",f));var Oe=function(e,t,n,r,i,o,s){var a=0,u=e.length,c=null==n;if("object"===he.type(n)){i=!0;for(a in n)Oe(e,t,a,n[a],!0,o,s)}else if(void 0!==r&&(i=!0,he.isFunction(r)||(s=!0),c&&(s?(t.call(e,r),t=null):(c=t,t=function(e,t,n){return c.call(he(e),n)})),t))for(;a<u;a++)t(e[a],n,s?r:r.call(e[a],a,t(e[a],n)));return i?e:c?t.call(e):u?t(e[0],n):o},qe=function(e){return 1===e.nodeType||9===e.nodeType||!+e.nodeType};d.uid=1,d.prototype={cache:function(e){var t=e[this.expando];return t||(t={},qe(e)&&(e.nodeType?e[this.expando]=t:Object.defineProperty(e,this.expando,{value:t,configurable:!0}))),t},set:function(e,t,n){var r,i=this.cache(e);if("string"==typeof t)i[he.camelCase(t)]=n;else for(r in t)i[he.camelCase(r)]=t[r];return i},get:function(e,t){return void 0===t?this.cache(e):e[this.expando]&&e[this.expando][he.camelCase(t)]},access:function(e,t,n){return void 0===t||t&&"string"==typeof t&&void 0===n?this.get(e,t):(this.set(e,t,n),void 0!==n?n:t)},remove:function(e,t){var n,r=e[this.expando];if(void 0!==r){if(void 0!==t){Array.isArray(t)?t=t.map(he.camelCase):(t=he.camelCase(t),t=t in r?[t]:t.match(Ae)||[]),n=t.length;for(;n--;)delete r[t[n]]}(void 0===t||he.isEmptyObject(r))&&(e.nodeType?e[this.expando]=void 0:delete e[this.expando])}},hasData:function(e){var t=e[this.expando];return void 0!==t&&!he.isEmptyObject(t)}};var Fe=new d,$e=new d,Pe=/^(?:\{[\w\W]*\}|\[[\w\W]*\])$/,He=/[A-Z]/g;he.extend({hasData:function(e){return $e.hasData(e)||Fe.hasData(e)},data:function(e,t,n){return $e.access(e,t,n)},removeData:function(e,t){$e.remove(e,t)},_data:function(e,t,n){return Fe.access(e,t,n)},_removeData:function(e,t){Fe.remove(e,t)}}),he.fn.extend({data:function(e,t){var n,r,i,o=this[0],s=o&&o.attributes;if(void 0===e){if(this.length&&(i=$e.get(o),1===o.nodeType&&!Fe.get(o,"hasDataAttrs"))){for(n=s.length;n--;)s[n]&&(r=s[n].name,0===r.indexOf("data-")&&(r=he.camelCase(r.slice(5)),h(o,r,i[r])));Fe.set(o,"hasDataAttrs",!0)}return i}return"object"==typeof e?this.each(function(){$e.set(this,e)}):Oe(this,function(t){var n;if(o&&void 0===t){if(void 0!==(n=$e.get(o,e)))return n;if(void 0!==(n=h(o,e)))return n}else this.each(function(){$e.set(this,e,t)})},null,t,arguments.length>1,null,!0)},removeData:function(e){return this.each(function(){$e.remove(this,e)})}}),he.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=Fe.get(e,t),n&&(!r||Array.isArray(n)?r=Fe.access(e,t,he.makeArray(n)):r.push(n)),r||[]},dequeue:function(e,t){t=t||"fx";var n=he.queue(e,t),r=n.length,i=n.shift(),o=he._queueHooks(e,t),s=function(){he.dequeue(e,t)};"inprogress"===i&&(i=n.shift(),r--),i&&("fx"===t&&n.unshift("inprogress"),delete o.stop,i.call(e,s,o)),!r&&o&&o.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return Fe.get(e,n)||Fe.access(e,n,{empty:he.Callbacks("once memory").add(function(){Fe.remove(e,[t+"queue",n])})})}}),he.fn.extend({queue:function(e,t){var n=2;return"string"!=typeof e&&(t=e,e="fx",n--),arguments.length<n?he.queue(this[0],e):void 0===t?this:this.each(function(){var n=he.queue(this,e,t);he._queueHooks(this,e),"fx"===e&&"inprogress"!==n[0]&&he.dequeue(this,e)})},dequeue:function(e){return this.each(function(){he.dequeue(this,e)})},clearQueue:function(e){return this.queue(e||"fx",[])},promise:function(e,t){var n,r=1,i=he.Deferred(),o=this,s=this.length,a=function(){--r||i.resolveWith(o,[o])};for("string"!=typeof e&&(t=e,e=void 0),e=e||"fx";s--;)(n=Fe.get(o[s],e+"queueHooks"))&&n.empty&&(r++,n.empty.add(a));return a(),i.promise(t)}});var Ie=/[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/.source,Re=new RegExp("^(?:([+-])=|)("+Ie+")([a-z%]*)$","i"),_e=["Top","Right","Bottom","Left"],Me=function(e,t){return e=t||e,"none"===e.style.display||""===e.style.display&&he.contains(e.ownerDocument,e)&&"none"===he.css(e,"display")},We=function(e,t,n,r){var i,o,s={};for(o in t)s[o]=e.style[o],e.style[o]=t[o];i=n.apply(e,r||[]);for(o in t)e.style[o]=s[o];return i},Be={};he.fn.extend({show:function(){return m(this,!0)},hide:function(){return m(this)},toggle:function(e){return"boolean"==typeof e?e?this.show():this.hide():this.each(function(){Me(this)?he(this).show():he(this).hide()})}});var ze=/^(?:checkbox|radio)$/i,Ve=/<([a-z][^\/\0>\x20\t\r\n\f]+)/i,Xe=/^$|\/(?:java|ecma)script/i,Ue={option:[1,"<select multiple='multiple'>","</select>"],thead:[1,"<table>","</table>"],col:[2,"<table><colgroup>","</colgroup></table>"],tr:[2,"<table><tbody>","</tbody></table>"],td:[3,"<table><tbody><tr>","</tr></tbody></table>"],_default:[0,"",""]};Ue.optgroup=Ue.option,Ue.tbody=Ue.tfoot=Ue.colgroup=Ue.caption=Ue.thead,Ue.th=Ue.td;var Qe=/<|&#?\w+;/;!function(){var e=ne.createDocumentFragment(),t=e.appendChild(ne.createElement("div")),n=ne.createElement("input");n.setAttribute("type","radio"),n.setAttribute("checked","checked"),n.setAttribute("name","t"),t.appendChild(n),pe.checkClone=t.cloneNode(!0).cloneNode(!0).lastChild.checked,t.innerHTML="<textarea>x</textarea>",pe.noCloneChecked=!!t.cloneNode(!0).lastChild.defaultValue}();var Ye=ne.documentElement,Je=/^key/,Ge=/^(?:mouse|pointer|contextmenu|drag|drop)|click/,Ke=/^([^.]*)(?:\.(.+)|)/;he.event={global:{},add:function(e,t,n,r,i){var o,s,a,u,c,l,f,d,p,h,g,v=Fe.get(e);if(v)for(n.handler&&(o=n,n=o.handler,i=o.selector),i&&he.find.matchesSelector(Ye,i),n.guid||(n.guid=he.guid++),(u=v.events)||(u=v.events={}),(s=v.handle)||(s=v.handle=function(t){return void 0!==he&&he.event.triggered!==t.type?he.event.dispatch.apply(e,arguments):void 0}),t=(t||"").match(Ae)||[""],c=t.length;c--;)a=Ke.exec(t[c])||[],p=g=a[1],h=(a[2]||"").split(".").sort(),p&&(f=he.event.special[p]||{},p=(i?f.delegateType:f.bindType)||p,f=he.event.special[p]||{},l=he.extend({type:p,origType:g,data:r,handler:n,guid:n.guid,selector:i,needsContext:i&&he.expr.match.needsContext.test(i),namespace:h.join(".")},o),(d=u[p])||(d=u[p]=[],d.delegateCount=0,f.setup&&!1!==f.setup.call(e,r,h,s)||e.addEventListener&&e.addEventListener(p,s)),f.add&&(f.add.call(e,l),l.handler.guid||(l.handler.guid=n.guid)),i?d.splice(d.delegateCount++,0,l):d.push(l),he.event.global[p]=!0)},remove:function(e,t,n,r,i){var o,s,a,u,c,l,f,d,p,h,g,v=Fe.hasData(e)&&Fe.get(e);if(v&&(u=v.events)){for(t=(t||"").match(Ae)||[""],c=t.length;c--;)if(a=Ke.exec(t[c])||[],p=g=a[1],h=(a[2]||"").split(".").sort(),p){for(f=he.event.special[p]||{},p=(r?f.delegateType:f.bindType)||p,d=u[p]||[],a=a[2]&&new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"),s=o=d.length;o--;)l=d[o],!i&&g!==l.origType||n&&n.guid!==l.guid||a&&!a.test(l.namespace)||r&&r!==l.selector&&("**"!==r||!l.selector)||(d.splice(o,1),l.selector&&d.delegateCount--,f.remove&&f.remove.call(e,l));s&&!d.length&&(f.teardown&&!1!==f.teardown.call(e,h,v.handle)||he.removeEvent(e,p,v.handle),delete u[p])}else for(p in u)he.event.remove(e,p+t[c],n,r,!0);he.isEmptyObject(u)&&Fe.remove(e,"handle events")}},dispatch:function(e){var t,n,r,i,o,s,a=he.event.fix(e),u=new Array(arguments.length),c=(Fe.get(this,"events")||{})[a.type]||[],l=he.event.special[a.type]||{};for(u[0]=a,t=1;t<arguments.length;t++)u[t]=arguments[t];if(a.delegateTarget=this,!l.preDispatch||!1!==l.preDispatch.call(this,a)){for(s=he.event.handlers.call(this,a,c),t=0;(i=s[t++])&&!a.isPropagationStopped();)for(a.currentTarget=i.elem,n=0;(o=i.handlers[n++])&&!a.isImmediatePropagationStopped();)a.rnamespace&&!a.rnamespace.test(o.namespace)||(a.handleObj=o,a.data=o.data,void 0!==(r=((he.event.special[o.origType]||{}).handle||o.handler).apply(i.elem,u))&&!1===(a.result=r)&&(a.preventDefault(),a.stopPropagation()));return l.postDispatch&&l.postDispatch.call(this,a),a.result}},handlers:function(e,t){var n,r,i,o,s,a=[],u=t.delegateCount,c=e.target;if(u&&c.nodeType&&!("click"===e.type&&e.button>=1))for(;c!==this;c=c.parentNode||this)if(1===c.nodeType&&("click"!==e.type||!0!==c.disabled)){for(o=[],s={},n=0;n<u;n++)r=t[n],i=r.selector+" ",void 0===s[i]&&(s[i]=r.needsContext?he(i,this).index(c)>-1:he.find(i,this,null,[c]).length),s[i]&&o.push(r);o.length&&a.push({elem:c,handlers:o})}return c=this,u<t.length&&a.push({elem:c,handlers:t.slice(u)}),a},addProp:function(e,t){Object.defineProperty(he.Event.prototype,e,{enumerable:!0,configurable:!0,get:he.isFunction(t)?function(){if(this.originalEvent)return t(this.originalEvent)}:function(){if(this.originalEvent)return this.originalEvent[e]},set:function(t){Object.defineProperty(this,e,{enumerable:!0,configurable:!0,writable:!0,value:t})}})},fix:function(e){return e[he.expando]?e:new he.Event(e)},special:{load:{noBubble:!0},focus:{trigger:function(){if(this!==S()&&this.focus)return this.focus(),!1},delegateType:"focusin"},blur:{trigger:function(){if(this===S()&&this.blur)return this.blur(),!1},delegateType:"focusout"},click:{trigger:function(){if("checkbox"===this.type&&this.click&&i(this,"input"))return this.click(),!1},_default:function(e){return i(e.target,"a")}},beforeunload:{postDispatch:function(e){void 0!==e.result&&e.originalEvent&&(e.originalEvent.returnValue=e.result)}}}},he.removeEvent=function(e,t,n){e.removeEventListener&&e.removeEventListener(t,n)},he.Event=function(e,t){if(!(this instanceof he.Event))return new he.Event(e,t);e&&e.type?(this.originalEvent=e,this.type=e.type,this.isDefaultPrevented=e.defaultPrevented||void 0===e.defaultPrevented&&!1===e.returnValue?w:T,this.target=e.target&&3===e.target.nodeType?e.target.parentNode:e.target,this.currentTarget=e.currentTarget,this.relatedTarget=e.relatedTarget):this.type=e,t&&he.extend(this,t),this.timeStamp=e&&e.timeStamp||he.now(),this[he.expando]=!0},he.Event.prototype={constructor:he.Event,isDefaultPrevented:T,isPropagationStopped:T,isImmediatePropagationStopped:T,isSimulated:!1,preventDefault:function(){var e=this.originalEvent;this.isDefaultPrevented=w,e&&!this.isSimulated&&e.preventDefault()},stopPropagation:function(){var e=this.originalEvent;this.isPropagationStopped=w,e&&!this.isSimulated&&e.stopPropagation()},stopImmediatePropagation:function(){var e=this.originalEvent;this.isImmediatePropagationStopped=w,e&&!this.isSimulated&&e.stopImmediatePropagation(),this.stopPropagation()}},he.each({altKey:!0,bubbles:!0,cancelable:!0,changedTouches:!0,ctrlKey:!0,detail:!0,eventPhase:!0,metaKey:!0,pageX:!0,pageY:!0,shiftKey:!0,view:!0,char:!0,charCode:!0,key:!0,keyCode:!0,button:!0,buttons:!0,clientX:!0,clientY:!0,offsetX:!0,offsetY:!0,pointerId:!0,pointerType:!0,screenX:!0,screenY:!0,targetTouches:!0,toElement:!0,touches:!0,which:function(e){var t=e.button;return null==e.which&&Je.test(e.type)?null!=e.charCode?e.charCode:e.keyCode:!e.which&&void 0!==t&&Ge.test(e.type)?1&t?1:2&t?3:4&t?2:0:e.which}},he.event.addProp),he.each({mouseenter:"mouseover",mouseleave:"mouseout",pointerenter:"pointerover",pointerleave:"pointerout"},function(e,t){he.event.special[e]={delegateType:t,bindType:t,handle:function(e){var n,r=this,i=e.relatedTarget,o=e.handleObj;return i&&(i===r||he.contains(r,i))||(e.type=o.origType,n=o.handler.apply(this,arguments),e.type=t),n}}}),he.fn.extend({on:function(e,t,n,r){return E(this,e,t,n,r)},one:function(e,t,n,r){return E(this,e,t,n,r,1)},off:function(e,t,n){var r,i;if(e&&e.preventDefault&&e.handleObj)return r=e.handleObj,he(e.delegateTarget).off(r.namespace?r.origType+"."+r.namespace:r.origType,r.selector,r.handler),this;if("object"==typeof e){for(i in e)this.off(i,t,e[i]);return this}return!1!==t&&"function"!=typeof t||(n=t,t=void 0),!1===n&&(n=T),this.each(function(){he.event.remove(this,e,n,t)})}});var Ze=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([a-z][^\/\0>\x20\t\r\n\f]*)[^>]*)\/>/gi,et=/<script|<style|<link/i,tt=/checked\s*(?:[^=]|=\s*.checked.)/i,nt=/^true\/(.*)/,rt=/^\s*<!(?:\[CDATA\[|--)|(?:\]\]|--)>\s*$/g;he.extend({htmlPrefilter:function(e){return e.replace(Ze,"<$1></$2>")},clone:function(e,t,n){var r,i,o,s,a=e.cloneNode(!0),u=he.contains(e.ownerDocument,e);if(!(pe.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||he.isXMLDoc(e)))for(s=y(a),o=y(e),r=0,i=o.length;r<i;r++)A(o[r],s[r]);if(t)if(n)for(o=o||y(e),s=s||y(a),r=0,i=o.length;r<i;r++)j(o[r],s[r]);else j(e,a);return s=y(a,"script"),s.length>0&&x(s,!u&&y(e,"script")),a},cleanData:function(e){for(var t,n,r,i=he.event.special,o=0;void 0!==(n=e[o]);o++)if(qe(n)){if(t=n[Fe.expando]){if(t.events)for(r in t.events)i[r]?he.event.remove(n,r):he.removeEvent(n,r,t.handle);n[Fe.expando]=void 0}n[$e.expando]&&(n[$e.expando]=void 0)}}}),he.fn.extend({detach:function(e){return D(this,e,!0)},remove:function(e){return D(this,e)},text:function(e){return Oe(this,function(e){return void 0===e?he.text(this):this.empty().each(function(){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||(this.textContent=e)})},null,e,arguments.length)},append:function(){return L(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){C(this,e).appendChild(e)}})},prepend:function(){return L(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=C(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return L(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return L(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},empty:function(){for(var e,t=0;null!=(e=this[t]);t++)1===e.nodeType&&(he.cleanData(y(e,!1)),e.textContent="");return this},clone:function(e,t){return e=null!=e&&e,t=null==t?e:t,this.map(function(){return he.clone(this,e,t)})},html:function(e){return Oe(this,function(e){var t=this[0]||{},n=0,r=this.length;if(void 0===e&&1===t.nodeType)return t.innerHTML;if("string"==typeof e&&!et.test(e)&&!Ue[(Ve.exec(e)||["",""])[1].toLowerCase()]){e=he.htmlPrefilter(e);try{for(;n<r;n++)t=this[n]||{},1===t.nodeType&&(he.cleanData(y(t,!1)),t.innerHTML=e);t=0}catch(e){}}t&&this.empty().append(e)},null,e,arguments.length)},replaceWith:function(){var e=[];return L(this,arguments,function(t){var n=this.parentNode;he.inArray(this,e)<0&&(he.cleanData(y(this)),n&&n.replaceChild(t,this))},e)}}),he.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(e,t){he.fn[e]=function(e){for(var n,r=[],i=he(e),o=i.length-1,s=0;s<=o;s++)n=s===o?this:this.clone(!0),he(i[s])[t](n),se.apply(r,n.get());return this.pushStack(r)}});var it=/^margin/,ot=new RegExp("^("+Ie+")(?!px)[a-z%]+$","i"),st=function(t){var n=t.ownerDocument.defaultView;return n&&n.opener||(n=e),n.getComputedStyle(t)};!function(){function t(){if(a){a.style.cssText="box-sizing:border-box;position:relative;display:block;margin:auto;border:1px;padding:1px;top:1%;width:50%",a.innerHTML="",Ye.appendChild(s);var t=e.getComputedStyle(a);n="1%"!==t.top,o="2px"===t.marginLeft,r="4px"===t.width,a.style.marginRight="50%",i="4px"===t.marginRight,Ye.removeChild(s),a=null}}var n,r,i,o,s=ne.createElement("div"),a=ne.createElement("div");a.style&&(a.style.backgroundClip="content-box",a.cloneNode(!0).style.backgroundClip="",pe.clearCloneStyle="content-box"===a.style.backgroundClip,s.style.cssText="border:0;width:8px;height:0;top:0;left:-9999px;padding:0;margin-top:1px;position:absolute",s.appendChild(a),he.extend(pe,{pixelPosition:function(){return t(),n},boxSizingReliable:function(){return t(),r},pixelMarginRight:function(){return t(),i},reliableMarginLeft:function(){return t(),o}}))}();var at=/^(none|table(?!-c[ea]).+)/,ut=/^--/,ct={position:"absolute",visibility:"hidden",display:"block"},lt={letterSpacing:"0",fontWeight:"400"},ft=["Webkit","Moz","ms"],dt=ne.createElement("div").style;he.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=O(e,"opacity");return""===n?"1":n}}}},cssNumber:{animationIterationCount:!0,columnCount:!0,fillOpacity:!0,flexGrow:!0,flexShrink:!0,fontWeight:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{float:"cssFloat"},style:function(e,t,n,r){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var i,o,s,a=he.camelCase(t),u=ut.test(t),c=e.style;if(u||(t=$(a)),s=he.cssHooks[t]||he.cssHooks[a],void 0===n)return s&&"get"in s&&void 0!==(i=s.get(e,!1,r))?i:c[t];o=typeof n,"string"===o&&(i=Re.exec(n))&&i[1]&&(n=g(e,t,i),o="number"),null!=n&&n===n&&("number"===o&&(n+=i&&i[3]||(he.cssNumber[a]?"":"px")),pe.clearCloneStyle||""!==n||0!==t.indexOf("background")||(c[t]="inherit"),s&&"set"in s&&void 0===(n=s.set(e,n,r))||(u?c.setProperty(t,n):c[t]=n))}},css:function(e,t,n,r){var i,o,s,a=he.camelCase(t);return ut.test(t)||(t=$(a)),s=he.cssHooks[t]||he.cssHooks[a],s&&"get"in s&&(i=s.get(e,!0,n)),void 0===i&&(i=O(e,t,r)),"normal"===i&&t in lt&&(i=lt[t]),""===n||n?(o=parseFloat(i),!0===n||isFinite(o)?o||0:i):i}}),he.each(["height","width"],function(e,t){he.cssHooks[t]={get:function(e,n,r){if(n)return!at.test(he.css(e,"display"))||e.getClientRects().length&&e.getBoundingClientRect().width?I(e,t,r):We(e,ct,function(){return I(e,t,r)})},set:function(e,n,r){var i,o=r&&st(e),s=r&&H(e,t,r,"border-box"===he.css(e,"boxSizing",!1,o),o);return s&&(i=Re.exec(n))&&"px"!==(i[3]||"px")&&(e.style[t]=n,n=he.css(e,t)),P(e,n,s)}}}),he.cssHooks.marginLeft=q(pe.reliableMarginLeft,function(e,t){if(t)return(parseFloat(O(e,"marginLeft"))||e.getBoundingClientRect().left-We(e,{marginLeft:0},function(){return e.getBoundingClientRect().left}))+"px"}),he.each({margin:"",padding:"",border:"Width"},function(e,t){he.cssHooks[e+t]={expand:function(n){for(var r=0,i={},o="string"==typeof n?n.split(" "):[n];r<4;r++)i[e+_e[r]+t]=o[r]||o[r-2]||o[0];return i}},it.test(e)||(he.cssHooks[e+t].set=P)}),he.fn.extend({css:function(e,t){return Oe(this,function(e,t,n){var r,i,o={},s=0;if(Array.isArray(t)){for(r=st(e),i=t.length;s<i;s++)o[t[s]]=he.css(e,t[s],!1,r);return o}return void 0!==n?he.style(e,t,n):he.css(e,t)},e,t,arguments.length>1)}}),he.Tween=R,R.prototype={constructor:R,init:function(e,t,n,r,i,o){this.elem=e,this.prop=n,this.easing=i||he.easing._default,this.options=t,this.start=this.now=this.cur(),this.end=r,this.unit=o||(he.cssNumber[n]?"":"px")},cur:function(){var e=R.propHooks[this.prop];return e&&e.get?e.get(this):R.propHooks._default.get(this)},run:function(e){var t,n=R.propHooks[this.prop];return this.options.duration?this.pos=t=he.easing[this.easing](e,this.options.duration*e,0,1,this.options.duration):this.pos=t=e,this.now=(this.end-this.start)*t+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),n&&n.set?n.set(this):R.propHooks._default.set(this),this}},R.prototype.init.prototype=R.prototype,R.propHooks={_default:{get:function(e){var t;return 1!==e.elem.nodeType||null!=e.elem[e.prop]&&null==e.elem.style[e.prop]?e.elem[e.prop]:(t=he.css(e.elem,e.prop,""),t&&"auto"!==t?t:0)},set:function(e){he.fx.step[e.prop]?he.fx.step[e.prop](e):1!==e.elem.nodeType||null==e.elem.style[he.cssProps[e.prop]]&&!he.cssHooks[e.prop]?e.elem[e.prop]=e.now:he.style(e.elem,e.prop,e.now+e.unit)}}},R.propHooks.scrollTop=R.propHooks.scrollLeft={set:function(e){e.elem.nodeType&&e.elem.parentNode&&(e.elem[e.prop]=e.now)}},he.easing={linear:function(e){return e},swing:function(e){return.5-Math.cos(e*Math.PI)/2},_default:"swing"},he.fx=R.prototype.init,he.fx.step={};var pt,ht,gt=/^(?:toggle|show|hide)$/,vt=/queueHooks$/;he.Animation=he.extend(X,{tweeners:{"*":[function(e,t){var n=this.createTween(e,t);return g(n.elem,e,Re.exec(t),n),n}]},tweener:function(e,t){he.isFunction(e)?(t=e,e=["*"]):e=e.match(Ae);for(var n,r=0,i=e.length;r<i;r++)n=e[r],X.tweeners[n]=X.tweeners[n]||[],X.tweeners[n].unshift(t)},prefilters:[z],prefilter:function(e,t){t?X.prefilters.unshift(e):X.prefilters.push(e)}}),he.speed=function(e,t,n){var r=e&&"object"==typeof e?he.extend({},e):{complete:n||!n&&t||he.isFunction(e)&&e,duration:e,easing:n&&t||t&&!he.isFunction(t)&&t};return he.fx.off?r.duration=0:"number"!=typeof r.duration&&(r.duration in he.fx.speeds?r.duration=he.fx.speeds[r.duration]:r.duration=he.fx.speeds._default),null!=r.queue&&!0!==r.queue||(r.queue="fx"),r.old=r.complete,r.complete=function(){he.isFunction(r.old)&&r.old.call(this),r.queue&&he.dequeue(this,r.queue)},r},he.fn.extend({fadeTo:function(e,t,n,r){return this.filter(Me).css("opacity",0).show().end().animate({opacity:t},e,n,r)},animate:function(e,t,n,r){var i=he.isEmptyObject(e),o=he.speed(t,n,r),s=function(){var t=X(this,he.extend({},e),o);(i||Fe.get(this,"finish"))&&t.stop(!0)};return s.finish=s,i||!1===o.queue?this.each(s):this.queue(o.queue,s)},stop:function(e,t,n){var r=function(e){var t=e.stop;delete e.stop,t(n)};return"string"!=typeof e&&(n=t,t=e,e=void 0),t&&!1!==e&&this.queue(e||"fx",[]),this.each(function(){var t=!0,i=null!=e&&e+"queueHooks",o=he.timers,s=Fe.get(this);if(i)s[i]&&s[i].stop&&r(s[i]);else for(i in s)s[i]&&s[i].stop&&vt.test(i)&&r(s[i])
  1315. ;for(i=o.length;i--;)o[i].elem!==this||null!=e&&o[i].queue!==e||(o[i].anim.stop(n),t=!1,o.splice(i,1));!t&&n||he.dequeue(this,e)})},finish:function(e){return!1!==e&&(e=e||"fx"),this.each(function(){var t,n=Fe.get(this),r=n[e+"queue"],i=n[e+"queueHooks"],o=he.timers,s=r?r.length:0;for(n.finish=!0,he.queue(this,e,[]),i&&i.stop&&i.stop.call(this,!0),t=o.length;t--;)o[t].elem===this&&o[t].queue===e&&(o[t].anim.stop(!0),o.splice(t,1));for(t=0;t<s;t++)r[t]&&r[t].finish&&r[t].finish.call(this);delete n.finish})}}),he.each(["toggle","show","hide"],function(e,t){var n=he.fn[t];he.fn[t]=function(e,r,i){return null==e||"boolean"==typeof e?n.apply(this,arguments):this.animate(W(t,!0),e,r,i)}}),he.each({slideDown:W("show"),slideUp:W("hide"),slideToggle:W("toggle"),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(e,t){he.fn[e]=function(e,n,r){return this.animate(t,e,n,r)}}),he.timers=[],he.fx.tick=function(){var e,t=0,n=he.timers;for(pt=he.now();t<n.length;t++)(e=n[t])()||n[t]!==e||n.splice(t--,1);n.length||he.fx.stop(),pt=void 0},he.fx.timer=function(e){he.timers.push(e),he.fx.start()},he.fx.interval=13,he.fx.start=function(){ht||(ht=!0,_())},he.fx.stop=function(){ht=null},he.fx.speeds={slow:600,fast:200,_default:400},he.fn.delay=function(t,n){return t=he.fx?he.fx.speeds[t]||t:t,n=n||"fx",this.queue(n,function(n,r){var i=e.setTimeout(n,t);r.stop=function(){e.clearTimeout(i)}})},function(){var e=ne.createElement("input"),t=ne.createElement("select"),n=t.appendChild(ne.createElement("option"));e.type="checkbox",pe.checkOn=""!==e.value,pe.optSelected=n.selected,e=ne.createElement("input"),e.value="t",e.type="radio",pe.radioValue="t"===e.value}();var mt,yt=he.expr.attrHandle;he.fn.extend({attr:function(e,t){return Oe(this,he.attr,e,t,arguments.length>1)},removeAttr:function(e){return this.each(function(){he.removeAttr(this,e)})}}),he.extend({attr:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return void 0===e.getAttribute?he.prop(e,t,n):(1===o&&he.isXMLDoc(e)||(i=he.attrHooks[t.toLowerCase()]||(he.expr.match.bool.test(t)?mt:void 0)),void 0!==n?null===n?void he.removeAttr(e,t):i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:(e.setAttribute(t,n+""),n):i&&"get"in i&&null!==(r=i.get(e,t))?r:(r=he.find.attr(e,t),null==r?void 0:r))},attrHooks:{type:{set:function(e,t){if(!pe.radioValue&&"radio"===t&&i(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},removeAttr:function(e,t){var n,r=0,i=t&&t.match(Ae);if(i&&1===e.nodeType)for(;n=i[r++];)e.removeAttribute(n)}}),mt={set:function(e,t,n){return!1===t?he.removeAttr(e,n):e.setAttribute(n,n),n}},he.each(he.expr.match.bool.source.match(/\w+/g),function(e,t){var n=yt[t]||he.find.attr;yt[t]=function(e,t,r){var i,o,s=t.toLowerCase();return r||(o=yt[s],yt[s]=i,i=null!=n(e,t,r)?s:null,yt[s]=o),i}});var xt=/^(?:input|select|textarea|button)$/i,bt=/^(?:a|area)$/i;he.fn.extend({prop:function(e,t){return Oe(this,he.prop,e,t,arguments.length>1)},removeProp:function(e){return this.each(function(){delete this[he.propFix[e]||e]})}}),he.extend({prop:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return 1===o&&he.isXMLDoc(e)||(t=he.propFix[t]||t,i=he.propHooks[t]),void 0!==n?i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:e[t]=n:i&&"get"in i&&null!==(r=i.get(e,t))?r:e[t]},propHooks:{tabIndex:{get:function(e){var t=he.find.attr(e,"tabindex");return t?parseInt(t,10):xt.test(e.nodeName)||bt.test(e.nodeName)&&e.href?0:-1}}},propFix:{for:"htmlFor",class:"className"}}),pe.optSelected||(he.propHooks.selected={get:function(e){var t=e.parentNode;return t&&t.parentNode&&t.parentNode.selectedIndex,null},set:function(e){var t=e.parentNode;t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex)}}),he.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){he.propFix[this.toLowerCase()]=this}),he.fn.extend({addClass:function(e){var t,n,r,i,o,s,a,u=0;if(he.isFunction(e))return this.each(function(t){he(this).addClass(e.call(this,t,Q(this)))});if("string"==typeof e&&e)for(t=e.match(Ae)||[];n=this[u++];)if(i=Q(n),r=1===n.nodeType&&" "+U(i)+" "){for(s=0;o=t[s++];)r.indexOf(" "+o+" ")<0&&(r+=o+" ");a=U(r),i!==a&&n.setAttribute("class",a)}return this},removeClass:function(e){var t,n,r,i,o,s,a,u=0;if(he.isFunction(e))return this.each(function(t){he(this).removeClass(e.call(this,t,Q(this)))});if(!arguments.length)return this.attr("class","");if("string"==typeof e&&e)for(t=e.match(Ae)||[];n=this[u++];)if(i=Q(n),r=1===n.nodeType&&" "+U(i)+" "){for(s=0;o=t[s++];)for(;r.indexOf(" "+o+" ")>-1;)r=r.replace(" "+o+" "," ");a=U(r),i!==a&&n.setAttribute("class",a)}return this},toggleClass:function(e,t){var n=typeof e;return"boolean"==typeof t&&"string"===n?t?this.addClass(e):this.removeClass(e):he.isFunction(e)?this.each(function(n){he(this).toggleClass(e.call(this,n,Q(this),t),t)}):this.each(function(){var t,r,i,o;if("string"===n)for(r=0,i=he(this),o=e.match(Ae)||[];t=o[r++];)i.hasClass(t)?i.removeClass(t):i.addClass(t);else void 0!==e&&"boolean"!==n||(t=Q(this),t&&Fe.set(this,"__className__",t),this.setAttribute&&this.setAttribute("class",t||!1===e?"":Fe.get(this,"__className__")||""))})},hasClass:function(e){var t,n,r=0;for(t=" "+e+" ";n=this[r++];)if(1===n.nodeType&&(" "+U(Q(n))+" ").indexOf(t)>-1)return!0;return!1}});var wt=/\r/g;he.fn.extend({val:function(e){var t,n,r,i=this[0];{if(arguments.length)return r=he.isFunction(e),this.each(function(n){var i;1===this.nodeType&&(i=r?e.call(this,n,he(this).val()):e,null==i?i="":"number"==typeof i?i+="":Array.isArray(i)&&(i=he.map(i,function(e){return null==e?"":e+""})),(t=he.valHooks[this.type]||he.valHooks[this.nodeName.toLowerCase()])&&"set"in t&&void 0!==t.set(this,i,"value")||(this.value=i))});if(i)return(t=he.valHooks[i.type]||he.valHooks[i.nodeName.toLowerCase()])&&"get"in t&&void 0!==(n=t.get(i,"value"))?n:(n=i.value,"string"==typeof n?n.replace(wt,""):null==n?"":n)}}}),he.extend({valHooks:{option:{get:function(e){var t=he.find.attr(e,"value");return null!=t?t:U(he.text(e))}},select:{get:function(e){var t,n,r,o=e.options,s=e.selectedIndex,a="select-one"===e.type,u=a?null:[],c=a?s+1:o.length;for(r=s<0?c:a?s:0;r<c;r++)if(n=o[r],(n.selected||r===s)&&!n.disabled&&(!n.parentNode.disabled||!i(n.parentNode,"optgroup"))){if(t=he(n).val(),a)return t;u.push(t)}return u},set:function(e,t){for(var n,r,i=e.options,o=he.makeArray(t),s=i.length;s--;)r=i[s],(r.selected=he.inArray(he.valHooks.option.get(r),o)>-1)&&(n=!0);return n||(e.selectedIndex=-1),o}}}}),he.each(["radio","checkbox"],function(){he.valHooks[this]={set:function(e,t){if(Array.isArray(t))return e.checked=he.inArray(he(e).val(),t)>-1}},pe.checkOn||(he.valHooks[this].get=function(e){return null===e.getAttribute("value")?"on":e.value})});var Tt=/^(?:focusinfocus|focusoutblur)$/;he.extend(he.event,{trigger:function(t,n,r,i){var o,s,a,u,c,l,f,d=[r||ne],p=le.call(t,"type")?t.type:t,h=le.call(t,"namespace")?t.namespace.split("."):[];if(s=a=r=r||ne,3!==r.nodeType&&8!==r.nodeType&&!Tt.test(p+he.event.triggered)&&(p.indexOf(".")>-1&&(h=p.split("."),p=h.shift(),h.sort()),c=p.indexOf(":")<0&&"on"+p,t=t[he.expando]?t:new he.Event(p,"object"==typeof t&&t),t.isTrigger=i?2:3,t.namespace=h.join("."),t.rnamespace=t.namespace?new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,t.result=void 0,t.target||(t.target=r),n=null==n?[t]:he.makeArray(n,[t]),f=he.event.special[p]||{},i||!f.trigger||!1!==f.trigger.apply(r,n))){if(!i&&!f.noBubble&&!he.isWindow(r)){for(u=f.delegateType||p,Tt.test(u+p)||(s=s.parentNode);s;s=s.parentNode)d.push(s),a=s;a===(r.ownerDocument||ne)&&d.push(a.defaultView||a.parentWindow||e)}for(o=0;(s=d[o++])&&!t.isPropagationStopped();)t.type=o>1?u:f.bindType||p,l=(Fe.get(s,"events")||{})[t.type]&&Fe.get(s,"handle"),l&&l.apply(s,n),(l=c&&s[c])&&l.apply&&qe(s)&&(t.result=l.apply(s,n),!1===t.result&&t.preventDefault());return t.type=p,i||t.isDefaultPrevented()||f._default&&!1!==f._default.apply(d.pop(),n)||!qe(r)||c&&he.isFunction(r[p])&&!he.isWindow(r)&&(a=r[c],a&&(r[c]=null),he.event.triggered=p,r[p](),he.event.triggered=void 0,a&&(r[c]=a)),t.result}},simulate:function(e,t,n){var r=he.extend(new he.Event,n,{type:e,isSimulated:!0});he.event.trigger(r,null,t)}}),he.fn.extend({trigger:function(e,t){return this.each(function(){he.event.trigger(e,t,this)})},triggerHandler:function(e,t){var n=this[0];if(n)return he.event.trigger(e,t,n,!0)}}),he.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(e,t){he.fn[t]=function(e,n){return arguments.length>0?this.on(t,null,e,n):this.trigger(t)}}),he.fn.extend({hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),pe.focusin="onfocusin"in e,pe.focusin||he.each({focus:"focusin",blur:"focusout"},function(e,t){var n=function(e){he.event.simulate(t,e.target,he.event.fix(e))};he.event.special[t]={setup:function(){var r=this.ownerDocument||this,i=Fe.access(r,t);i||r.addEventListener(e,n,!0),Fe.access(r,t,(i||0)+1)},teardown:function(){var r=this.ownerDocument||this,i=Fe.access(r,t)-1;i?Fe.access(r,t,i):(r.removeEventListener(e,n,!0),Fe.remove(r,t))}}});var St=e.location,Et=he.now(),Ct=/\?/;he.parseXML=function(t){var n;if(!t||"string"!=typeof t)return null;try{n=(new e.DOMParser).parseFromString(t,"text/xml")}catch(e){n=void 0}return n&&!n.getElementsByTagName("parsererror").length||he.error("Invalid XML: "+t),n};var kt=/\[\]$/,Nt=/\r?\n/g,jt=/^(?:submit|button|image|reset|file)$/i,At=/^(?:input|select|textarea|keygen)/i;he.param=function(e,t){var n,r=[],i=function(e,t){var n=he.isFunction(t)?t():t;r[r.length]=encodeURIComponent(e)+"="+encodeURIComponent(null==n?"":n)};if(Array.isArray(e)||e.jquery&&!he.isPlainObject(e))he.each(e,function(){i(this.name,this.value)});else for(n in e)Y(n,e[n],t,i);return r.join("&")},he.fn.extend({serialize:function(){return he.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=he.prop(this,"elements");return e?he.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!he(this).is(":disabled")&&At.test(this.nodeName)&&!jt.test(e)&&(this.checked||!ze.test(e))}).map(function(e,t){var n=he(this).val();return null==n?null:Array.isArray(n)?he.map(n,function(e){return{name:t.name,value:e.replace(Nt,"\r\n")}}):{name:t.name,value:n.replace(Nt,"\r\n")}}).get()}});var Lt=/%20/g,Dt=/#.*$/,Ot=/([?&])_=[^&]*/,qt=/^(.*?):[ \t]*([^\r\n]*)$/gm,Ft=/^(?:about|app|app-storage|.+-extension|file|res|widget):$/,$t=/^(?:GET|HEAD)$/,Pt=/^\/\//,Ht={},It={},Rt="*/".concat("*"),_t=ne.createElement("a");_t.href=St.href,he.extend({active:0,lastModified:{},etag:{},ajaxSettings:{url:St.href,type:"GET",isLocal:Ft.test(St.protocol),global:!0,processData:!0,async:!0,contentType:"application/x-www-form-urlencoded; charset=UTF-8",accepts:{"*":Rt,text:"text/plain",html:"text/html",xml:"application/xml, text/xml",json:"application/json, text/javascript"},contents:{xml:/\bxml\b/,html:/\bhtml/,json:/\bjson\b/},responseFields:{xml:"responseXML",text:"responseText",json:"responseJSON"},converters:{"* text":String,"text html":!0,"text json":JSON.parse,"text xml":he.parseXML},flatOptions:{url:!0,context:!0}},ajaxSetup:function(e,t){return t?K(K(e,he.ajaxSettings),t):K(he.ajaxSettings,e)},ajaxPrefilter:J(Ht),ajaxTransport:J(It),ajax:function(t,n){function r(t,n,r,a){var c,d,p,b,w,T=n;l||(l=!0,u&&e.clearTimeout(u),i=void 0,s=a||"",S.readyState=t>0?4:0,c=t>=200&&t<300||304===t,r&&(b=Z(h,S,r)),b=ee(h,b,S,c),c?(h.ifModified&&(w=S.getResponseHeader("Last-Modified"),w&&(he.lastModified[o]=w),(w=S.getResponseHeader("etag"))&&(he.etag[o]=w)),204===t||"HEAD"===h.type?T="nocontent":304===t?T="notmodified":(T=b.state,d=b.data,p=b.error,c=!p)):(p=T,!t&&T||(T="error",t<0&&(t=0))),S.status=t,S.statusText=(n||T)+"",c?m.resolveWith(g,[d,T,S]):m.rejectWith(g,[S,T,p]),S.statusCode(x),x=void 0,f&&v.trigger(c?"ajaxSuccess":"ajaxError",[S,h,c?d:p]),y.fireWith(g,[S,T]),f&&(v.trigger("ajaxComplete",[S,h]),--he.active||he.event.trigger("ajaxStop")))}"object"==typeof t&&(n=t,t=void 0),n=n||{};var i,o,s,a,u,c,l,f,d,p,h=he.ajaxSetup({},n),g=h.context||h,v=h.context&&(g.nodeType||g.jquery)?he(g):he.event,m=he.Deferred(),y=he.Callbacks("once memory"),x=h.statusCode||{},b={},w={},T="canceled",S={readyState:0,getResponseHeader:function(e){var t;if(l){if(!a)for(a={};t=qt.exec(s);)a[t[1].toLowerCase()]=t[2];t=a[e.toLowerCase()]}return null==t?null:t},getAllResponseHeaders:function(){return l?s:null},setRequestHeader:function(e,t){return null==l&&(e=w[e.toLowerCase()]=w[e.toLowerCase()]||e,b[e]=t),this},overrideMimeType:function(e){return null==l&&(h.mimeType=e),this},statusCode:function(e){var t;if(e)if(l)S.always(e[S.status]);else for(t in e)x[t]=[x[t],e[t]];return this},abort:function(e){var t=e||T;return i&&i.abort(t),r(0,t),this}};if(m.promise(S),h.url=((t||h.url||St.href)+"").replace(Pt,St.protocol+"//"),h.type=n.method||n.type||h.method||h.type,h.dataTypes=(h.dataType||"*").toLowerCase().match(Ae)||[""],null==h.crossDomain){c=ne.createElement("a");try{c.href=h.url,c.href=c.href,h.crossDomain=_t.protocol+"//"+_t.host!=c.protocol+"//"+c.host}catch(e){h.crossDomain=!0}}if(h.data&&h.processData&&"string"!=typeof h.data&&(h.data=he.param(h.data,h.traditional)),G(Ht,h,n,S),l)return S;f=he.event&&h.global,f&&0==he.active++&&he.event.trigger("ajaxStart"),h.type=h.type.toUpperCase(),h.hasContent=!$t.test(h.type),o=h.url.replace(Dt,""),h.hasContent?h.data&&h.processData&&0===(h.contentType||"").indexOf("application/x-www-form-urlencoded")&&(h.data=h.data.replace(Lt,"+")):(p=h.url.slice(o.length),h.data&&(o+=(Ct.test(o)?"&":"?")+h.data,delete h.data),!1===h.cache&&(o=o.replace(Ot,"$1"),p=(Ct.test(o)?"&":"?")+"_="+Et+++p),h.url=o+p),h.ifModified&&(he.lastModified[o]&&S.setRequestHeader("If-Modified-Since",he.lastModified[o]),he.etag[o]&&S.setRequestHeader("If-None-Match",he.etag[o])),(h.data&&h.hasContent&&!1!==h.contentType||n.contentType)&&S.setRequestHeader("Content-Type",h.contentType),S.setRequestHeader("Accept",h.dataTypes[0]&&h.accepts[h.dataTypes[0]]?h.accepts[h.dataTypes[0]]+("*"!==h.dataTypes[0]?", "+Rt+"; q=0.01":""):h.accepts["*"]);for(d in h.headers)S.setRequestHeader(d,h.headers[d]);if(h.beforeSend&&(!1===h.beforeSend.call(g,S,h)||l))return S.abort();if(T="abort",y.add(h.complete),S.done(h.success),S.fail(h.error),i=G(It,h,n,S)){if(S.readyState=1,f&&v.trigger("ajaxSend",[S,h]),l)return S;h.async&&h.timeout>0&&(u=e.setTimeout(function(){S.abort("timeout")},h.timeout));try{l=!1,i.send(b,r)}catch(e){if(l)throw e;r(-1,e)}}else r(-1,"No Transport");return S},getJSON:function(e,t,n){return he.get(e,t,n,"json")},getScript:function(e,t){return he.get(e,void 0,t,"script")}}),he.each(["get","post"],function(e,t){he[t]=function(e,n,r,i){return he.isFunction(n)&&(i=i||r,r=n,n=void 0),he.ajax(he.extend({url:e,type:t,dataType:i,data:n,success:r},he.isPlainObject(e)&&e))}}),he._evalUrl=function(e){return he.ajax({url:e,type:"GET",dataType:"script",cache:!0,async:!1,global:!1,throws:!0})},he.fn.extend({wrapAll:function(e){var t;return this[0]&&(he.isFunction(e)&&(e=e.call(this[0])),t=he(e,this[0].ownerDocument).eq(0).clone(!0),this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){for(var e=this;e.firstElementChild;)e=e.firstElementChild;return e}).append(this)),this},wrapInner:function(e){return he.isFunction(e)?this.each(function(t){he(this).wrapInner(e.call(this,t))}):this.each(function(){var t=he(this),n=t.contents();n.length?n.wrapAll(e):t.append(e)})},wrap:function(e){var t=he.isFunction(e);return this.each(function(n){he(this).wrapAll(t?e.call(this,n):e)})},unwrap:function(e){return this.parent(e).not("body").each(function(){he(this).replaceWith(this.childNodes)}),this}}),he.expr.pseudos.hidden=function(e){return!he.expr.pseudos.visible(e)},he.expr.pseudos.visible=function(e){return!!(e.offsetWidth||e.offsetHeight||e.getClientRects().length)},he.ajaxSettings.xhr=function(){try{return new e.XMLHttpRequest}catch(e){}};var Mt={0:200,1223:204},Wt=he.ajaxSettings.xhr();pe.cors=!!Wt&&"withCredentials"in Wt,pe.ajax=Wt=!!Wt,he.ajaxTransport(function(t){var n,r;if(pe.cors||Wt&&!t.crossDomain)return{send:function(i,o){var s,a=t.xhr();if(a.open(t.type,t.url,t.async,t.username,t.password),t.xhrFields)for(s in t.xhrFields)a[s]=t.xhrFields[s];t.mimeType&&a.overrideMimeType&&a.overrideMimeType(t.mimeType),t.crossDomain||i["X-Requested-With"]||(i["X-Requested-With"]="XMLHttpRequest");for(s in i)a.setRequestHeader(s,i[s]);n=function(e){return function(){n&&(n=r=a.onload=a.onerror=a.onabort=a.onreadystatechange=null,"abort"===e?a.abort():"error"===e?"number"!=typeof a.status?o(0,"error"):o(a.status,a.statusText):o(Mt[a.status]||a.status,a.statusText,"text"!==(a.responseType||"text")||"string"!=typeof a.responseText?{binary:a.response}:{text:a.responseText},a.getAllResponseHeaders()))}},a.onload=n(),r=a.onerror=n("error"),void 0!==a.onabort?a.onabort=r:a.onreadystatechange=function(){4===a.readyState&&e.setTimeout(function(){n&&r()})},n=n("abort");try{a.send(t.hasContent&&t.data||null)}catch(e){if(n)throw e}},abort:function(){n&&n()}}}),he.ajaxPrefilter(function(e){e.crossDomain&&(e.contents.script=!1)}),he.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/\b(?:java|ecma)script\b/},converters:{"text script":function(e){return he.globalEval(e),e}}}),he.ajaxPrefilter("script",function(e){void 0===e.cache&&(e.cache=!1),e.crossDomain&&(e.type="GET")}),he.ajaxTransport("script",function(e){if(e.crossDomain){var t,n;return{send:function(r,i){t=he("<script>").prop({charset:e.scriptCharset,src:e.url}).on("load error",n=function(e){t.remove(),n=null,e&&i("error"===e.type?404:200,e.type)}),ne.head.appendChild(t[0])},abort:function(){n&&n()}}}});var Bt=[],zt=/(=)\?(?=&|$)|\?\?/;he.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var e=Bt.pop()||he.expando+"_"+Et++;return this[e]=!0,e}}),he.ajaxPrefilter("json jsonp",function(t,n,r){var i,o,s,a=!1!==t.jsonp&&(zt.test(t.url)?"url":"string"==typeof t.data&&0===(t.contentType||"").indexOf("application/x-www-form-urlencoded")&&zt.test(t.data)&&"data");if(a||"jsonp"===t.dataTypes[0])return i=t.jsonpCallback=he.isFunction(t.jsonpCallback)?t.jsonpCallback():t.jsonpCallback,a?t[a]=t[a].replace(zt,"$1"+i):!1!==t.jsonp&&(t.url+=(Ct.test(t.url)?"&":"?")+t.jsonp+"="+i),t.converters["script json"]=function(){return s||he.error(i+" was not called"),s[0]},t.dataTypes[0]="json",o=e[i],e[i]=function(){s=arguments},r.always(function(){void 0===o?he(e).removeProp(i):e[i]=o,t[i]&&(t.jsonpCallback=n.jsonpCallback,Bt.push(i)),s&&he.isFunction(o)&&o(s[0]),s=o=void 0}),"script"}),pe.createHTMLDocument=function(){var e=ne.implementation.createHTMLDocument("").body;return e.innerHTML="<form></form><form></form>",2===e.childNodes.length}(),he.parseHTML=function(e,t,n){if("string"!=typeof e)return[];"boolean"==typeof t&&(n=t,t=!1);var r,i,o;return t||(pe.createHTMLDocument?(t=ne.implementation.createHTMLDocument(""),r=t.createElement("base"),r.href=ne.location.href,t.head.appendChild(r)):t=ne),i=Se.exec(e),o=!n&&[],i?[t.createElement(i[1])]:(i=b([e],t,o),o&&o.length&&he(o).remove(),he.merge([],i.childNodes))},he.fn.load=function(e,t,n){var r,i,o,s=this,a=e.indexOf(" ");return a>-1&&(r=U(e.slice(a)),e=e.slice(0,a)),he.isFunction(t)?(n=t,t=void 0):t&&"object"==typeof t&&(i="POST"),s.length>0&&he.ajax({url:e,type:i||"GET",dataType:"html",data:t}).done(function(e){o=arguments,s.html(r?he("<div>").append(he.parseHTML(e)).find(r):e)}).always(n&&function(e,t){s.each(function(){n.apply(this,o||[e.responseText,t,e])})}),this},he.each(["ajaxStart","ajaxStop","ajaxComplete","ajaxError","ajaxSuccess","ajaxSend"],function(e,t){he.fn[t]=function(e){return this.on(t,e)}}),he.expr.pseudos.animated=function(e){return he.grep(he.timers,function(t){return e===t.elem}).length},he.offset={setOffset:function(e,t,n){var r,i,o,s,a,u,c,l=he.css(e,"position"),f=he(e),d={};"static"===l&&(e.style.position="relative"),a=f.offset(),o=he.css(e,"top"),u=he.css(e,"left"),c=("absolute"===l||"fixed"===l)&&(o+u).indexOf("auto")>-1,c?(r=f.position(),s=r.top,i=r.left):(s=parseFloat(o)||0,i=parseFloat(u)||0),he.isFunction(t)&&(t=t.call(e,n,he.extend({},a))),null!=t.top&&(d.top=t.top-a.top+s),null!=t.left&&(d.left=t.left-a.left+i),"using"in t?t.using.call(e,d):f.css(d)}},he.fn.extend({offset:function(e){if(arguments.length)return void 0===e?this:this.each(function(t){he.offset.setOffset(this,e,t)});var t,n,r,i,o=this[0];if(o)return o.getClientRects().length?(r=o.getBoundingClientRect(),t=o.ownerDocument,n=t.documentElement,i=t.defaultView,{top:r.top+i.pageYOffset-n.clientTop,left:r.left+i.pageXOffset-n.clientLeft}):{top:0,left:0}},position:function(){if(this[0]){var e,t,n=this[0],r={top:0,left:0};return"fixed"===he.css(n,"position")?t=n.getBoundingClientRect():(e=this.offsetParent(),t=this.offset(),i(e[0],"html")||(r=e.offset()),r={top:r.top+he.css(e[0],"borderTopWidth",!0),left:r.left+he.css(e[0],"borderLeftWidth",!0)}),{top:t.top-r.top-he.css(n,"marginTop",!0),left:t.left-r.left-he.css(n,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){for(var e=this.offsetParent;e&&"static"===he.css(e,"position");)e=e.offsetParent;return e||Ye})}}),he.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(e,t){var n="pageYOffset"===t;he.fn[e]=function(r){return Oe(this,function(e,r,i){var o;if(he.isWindow(e)?o=e:9===e.nodeType&&(o=e.defaultView),void 0===i)return o?o[t]:e[r];o?o.scrollTo(n?o.pageXOffset:i,n?i:o.pageYOffset):e[r]=i},e,r,arguments.length)}}),he.each(["top","left"],function(e,t){he.cssHooks[t]=q(pe.pixelPosition,function(e,n){if(n)return n=O(e,t),ot.test(n)?he(e).position()[t]+"px":n})}),he.each({Height:"height",Width:"width"},function(e,t){he.each({padding:"inner"+e,content:t,"":"outer"+e},function(n,r){he.fn[r]=function(i,o){var s=arguments.length&&(n||"boolean"!=typeof i),a=n||(!0===i||!0===o?"margin":"border");return Oe(this,function(t,n,i){var o;return he.isWindow(t)?0===r.indexOf("outer")?t["inner"+e]:t.document.documentElement["client"+e]:9===t.nodeType?(o=t.documentElement,Math.max(t.body["scroll"+e],o["scroll"+e],t.body["offset"+e],o["offset"+e],o["client"+e])):void 0===i?he.css(t,n,a):he.style(t,n,i,a)},t,s?i:void 0,s)}})}),he.fn.extend({bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)}}),he.holdReady=function(e){e?he.readyWait++:he.ready(!0)},he.isArray=Array.isArray,he.parseJSON=JSON.parse,he.nodeName=i,"function"==typeof define&&define.amd&&define("jquery",[],function(){return he});var Vt=e.jQuery,Xt=e.$;return he.noConflict=function(t){return e.$===he&&(e.$=Xt),t&&e.jQuery===he&&(e.jQuery=Vt),he},t||(e.jQuery=e.$=he),he}),jQuery.extend({highlight:function(e,t,n,r){if(3===e.nodeType){var i=e.data.match(t);if(i){var o=document.createElement(n||"span");o.className=r||"highlight";var s=e.splitText(i.index);s.splitText(i[0].length);var a=s.cloneNode(!0);return o.appendChild(a),s.parentNode.replaceChild(o,s),1}}else if(1===e.nodeType&&e.childNodes&&!/(script|style)/i.test(e.tagName)&&(e.tagName!==n.toUpperCase()||e.className!==r))for(var u=0;u<e.childNodes.length;u++)u+=jQuery.highlight(e.childNodes[u],t,n,r);return 0}}),jQuery.fn.unhighlight=function(e){var t={className:"highlight",element:"span"};return jQuery.extend(t,e),this.find(t.element+"."+t.className).each(function(){var e=this.parentNode;e.replaceChild(this.firstChild,this),e.normalize()}).end()},jQuery.fn.highlight=function(e,t){var n={className:"highlight",element:"span",caseSensitive:!1,wordsOnly:!1};if(jQuery.extend(n,t),e.constructor===String&&(e=[e]),e=jQuery.grep(e,function(e,t){return""!=e}),e=jQuery.map(e,function(e,t){return e.replace(/[-[\]{}()*+?.,\\^$|#\s]/g,"\\$&")}),0==e.length)return this;var r=n.caseSensitive?"":"i",i="("+e.join("|")+")";n.wordsOnly&&(i="\\b"+i+"\\b");var o=new RegExp(i,r);return this.each(function(){jQuery.highlight(this,o,n.element,n.className)})},function(){var e=function(t){var n=new e.Index;return n.pipeline.add(e.trimmer,e.stopWordFilter,e.stemmer),t&&t.call(n,n),n};e.version="0.5.7",e.utils={},e.utils.warn=function(e){return function(t){e.console&&console.warn&&console.warn(t)}}(this),e.EventEmitter=function(){this.events={}},e.EventEmitter.prototype.addListener=function(){var e=Array.prototype.slice.call(arguments),t=e.pop(),n=e;if("function"!=typeof t)throw new TypeError("last argument must be a function");n.forEach(function(e){this.hasHandler(e)||(this.events[e]=[]),this.events[e].push(t)},this)},e.EventEmitter.prototype.removeListener=function(e,t){if(this.hasHandler(e)){var n=this.events[e].indexOf(t);this.events[e].splice(n,1),this.events[e].length||delete this.events[e]}},e.EventEmitter.prototype.emit=function(e){if(this.hasHandler(e)){var t=Array.prototype.slice.call(arguments,1);this.events[e].forEach(function(e){e.apply(void 0,t)})}},e.EventEmitter.prototype.hasHandler=function(e){return e in this.events},e.tokenizer=function(e){if(!arguments.length||null==e||void 0==e)return[];if(Array.isArray(e))return e.map(function(e){return e.toLowerCase()});for(var t=e.toString().replace(/^\s+/,""),n=t.length-1;n>=0;n--)if(/\S/.test(t.charAt(n))){t=t.substring(0,n+1);break}return t.split(/(?:\s+|\-)/).filter(function(e){return!!e}).map(function(e){return e.toLowerCase()})},e.Pipeline=function(){this._stack=[]},e.Pipeline.registeredFunctions={},e.Pipeline.registerFunction=function(t,n){n in this.registeredFunctions&&e.utils.warn("Overwriting existing registered function: "+n),t.label=n,e.Pipeline.registeredFunctions[t.label]=t},e.Pipeline.warnIfFunctionNotRegistered=function(t){t.label&&t.label in this.registeredFunctions||e.utils.warn("Function is not registered with pipeline. This may cause problems when serialising the index.\n",t)},e.Pipeline.load=function(t){var n=new e.Pipeline;return t.forEach(function(t){var r=e.Pipeline.registeredFunctions[t];if(!r)throw new Error("Cannot load un-registered function: "+t);n.add(r)}),n},e.Pipeline.prototype.add=function(){Array.prototype.slice.call(arguments).forEach(function(t){e.Pipeline.warnIfFunctionNotRegistered(t),this._stack.push(t)},this)},e.Pipeline.prototype.after=function(t,n){e.Pipeline.warnIfFunctionNotRegistered(n);var r=this._stack.indexOf(t)+1;this._stack.splice(r,0,n)},e.Pipeline.prototype.before=function(t,n){e.Pipeline.warnIfFunctionNotRegistered(n);var r=this._stack.indexOf(t);this._stack.splice(r,0,n)},e.Pipeline.prototype.remove=function(e){var t=this._stack.indexOf(e);this._stack.splice(t,1)},e.Pipeline.prototype.run=function(e){for(var t=[],n=e.length,r=this._stack.length,i=0;i<n;i++){for(var o=e[i],s=0;s<r&&void 0!==(o=this._stack[s](o,i,e));s++);void 0!==o&&t.push(o)}return t},e.Pipeline.prototype.reset=function(){this._stack=[]},e.Pipeline.prototype.toJSON=function(){return this._stack.map(function(t){return e.Pipeline.warnIfFunctionNotRegistered(t),t.label})},e.Vector=function(){this._magnitude=null,this.list=void 0,this.length=0},e.Vector.Node=function(e,t,n){this.idx=e,this.val=t,this.next=n},e.Vector.prototype.insert=function(t,n){var r=this.list;if(!r)return this.list=new e.Vector.Node(t,n,r),this.length++;for(var i=r,o=r.next;void 0!=o;){if(t<o.idx)return i.next=new e.Vector.Node(t,n,o),this.length++;i=o,o=o.next}return i.next=new e.Vector.Node(t,n,o),this.length++},e.Vector.prototype.magnitude=function(){if(this._magniture)return this._magnitude;for(var e,t=this.list,n=0;t;)e=t.val,n+=e*e,t=t.next;return this._magnitude=Math.sqrt(n)},e.Vector.prototype.dot=function(e){for(var t=this.list,n=e.list,r=0;t&&n;)t.idx<n.idx?t=t.next:t.idx>n.idx?n=n.next:(r+=t.val*n.val,t=t.next,n=n.next);return r},e.Vector.prototype.similarity=function(e){return this.dot(e)/(this.magnitude()*e.magnitude())},e.SortedSet=function(){this.length=0,this.elements=[]},e.SortedSet.load=function(e){var t=new this;return t.elements=e,t.length=e.length,t},e.SortedSet.prototype.add=function(){Array.prototype.slice.call(arguments).forEach(function(e){~this.indexOf(e)||this.elements.splice(this.locationFor(e),0,e)},this),this.length=this.elements.length},e.SortedSet.prototype.toArray=function(){return this.elements.slice()},e.SortedSet.prototype.map=function(e,t){return this.elements.map(e,t)},e.SortedSet.prototype.forEach=function(e,t){return this.elements.forEach(e,t)},e.SortedSet.prototype.indexOf=function(e,t,n){var t=t||0,n=n||this.elements.length,r=n-t,i=t+Math.floor(r/2),o=this.elements[i];return r<=1?o===e?i:-1:o<e?this.indexOf(e,i,n):o>e?this.indexOf(e,t,i):o===e?i:void 0},e.SortedSet.prototype.locationFor=function(e,t,n){var t=t||0,n=n||this.elements.length,r=n-t,i=t+Math.floor(r/2),o=this.elements[i];if(r<=1){if(o>e)return i;if(o<e)return i+1}return o<e?this.locationFor(e,i,n):o>e?this.locationFor(e,t,i):void 0},e.SortedSet.prototype.intersect=function(t){for(var n=new e.SortedSet,r=0,i=0,o=this.length,s=t.length,a=this.elements,u=t.elements;;){if(r>o-1||i>s-1)break;a[r]!==u[i]?a[r]<u[i]?r++:a[r]>u[i]&&i++:(n.add(a[r]),r++,i++)}return n},e.SortedSet.prototype.clone=function(){var t=new e.SortedSet;return t.elements=this.toArray(),t.length=t.elements.length,t},e.SortedSet.prototype.union=function(e){var t,n,r;return this.length>=e.length?(t=this,n=e):(t=e,n=this),r=t.clone(),r.add.apply(r,n.toArray()),r},e.SortedSet.prototype.toJSON=function(){return this.toArray()},e.Index=function(){this._fields=[],this._ref="id",this.pipeline=new e.Pipeline,this.documentStore=new e.Store,this.tokenStore=new e.TokenStore,this.corpusTokens=new e.SortedSet,this.eventEmitter=new e.EventEmitter,this._idfCache={},this.on("add","remove","update",function(){this._idfCache={}}.bind(this))},e.Index.prototype.on=function(){var e=Array.prototype.slice.call(arguments);return this.eventEmitter.addListener.apply(this.eventEmitter,e)},e.Index.prototype.off=function(e,t){return this.eventEmitter.removeListener(e,t)},e.Index.load=function(t){t.version!==e.version&&e.utils.warn("version mismatch: current "+e.version+" importing "+t.version);var n=new this;return n._fields=t.fields,n._ref=t.ref,n.documentStore=e.Store.load(t.documentStore),n.tokenStore=e.TokenStore.load(t.tokenStore),n.corpusTokens=e.SortedSet.load(t.corpusTokens),n.pipeline=e.Pipeline.load(t.pipeline),n},e.Index.prototype.field=function(e,t){var t=t||{},n={name:e,boost:t.boost||1};return this._fields.push(n),this},e.Index.prototype.ref=function(e){return this._ref=e,this},e.Index.prototype.add=function(t,n){var r={},i=new e.SortedSet,o=t[this._ref],n=void 0===n||n;this._fields.forEach(function(n){var o=this.pipeline.run(e.tokenizer(t[n.name]));r[n.name]=o,e.SortedSet.prototype.add.apply(i,o)},this),this.documentStore.set(o,i),e.SortedSet.prototype.add.apply(this.corpusTokens,i.toArray());for(var s=0;s<i.length;s++){var a=i.elements[s],u=this._fields.reduce(function(e,t){var n=r[t.name].length;return n?e+r[t.name].filter(function(e){return e===a}).length/n*t.boost:e},0);this.tokenStore.add(a,{ref:o,tf:u})}n&&this.eventEmitter.emit("add",t,this)},e.Index.prototype.remove=function(e,t){var n=e[this._ref],t=void 0===t||t;if(this.documentStore.has(n)){var r=this.documentStore.get(n);this.documentStore.remove(n),r.forEach(function(e){this.tokenStore.remove(e,n)},this),t&&this.eventEmitter.emit("remove",e,this)}},e.Index.prototype.update=function(e,t){var t=void 0===t||t;this.remove(e,!1),this.add(e,!1),t&&this.eventEmitter.emit("update",e,this)},e.Index.prototype.idf=function(e){var t="@"+e;if(Object.prototype.hasOwnProperty.call(this._idfCache,t))return this._idfCache[t];var n=this.tokenStore.count(e),r=1;return n>0&&(r=1+Math.log(this.tokenStore.length/n)),this._idfCache[t]=r},e.Index.prototype.search=function(t){
  1316. var n=this.pipeline.run(e.tokenizer(t)),r=new e.Vector,i=[],o=this._fields.reduce(function(e,t){return e+t.boost},0);return n.some(function(e){return this.tokenStore.has(e)},this)?(n.forEach(function(t,n,s){var a=1/s.length*this._fields.length*o,u=this,c=this.tokenStore.expand(t).reduce(function(n,i){var o=u.corpusTokens.indexOf(i),s=u.idf(i),c=1,l=new e.SortedSet;if(i!==t){var f=Math.max(3,i.length-t.length);c=1/Math.log(f)}return o>-1&&r.insert(o,a*s*c),Object.keys(u.tokenStore.get(i)).forEach(function(e){l.add(e)}),n.union(l)},new e.SortedSet);i.push(c)},this),i.reduce(function(e,t){return e.intersect(t)}).map(function(e){return{ref:e,score:r.similarity(this.documentVector(e))}},this).sort(function(e,t){return t.score-e.score})):[]},e.Index.prototype.documentVector=function(t){for(var n=this.documentStore.get(t),r=n.length,i=new e.Vector,o=0;o<r;o++){var s=n.elements[o],a=this.tokenStore.get(s)[t].tf,u=this.idf(s);i.insert(this.corpusTokens.indexOf(s),a*u)}return i},e.Index.prototype.toJSON=function(){return{version:e.version,fields:this._fields,ref:this._ref,documentStore:this.documentStore.toJSON(),tokenStore:this.tokenStore.toJSON(),corpusTokens:this.corpusTokens.toJSON(),pipeline:this.pipeline.toJSON()}},e.Index.prototype.use=function(e){var t=Array.prototype.slice.call(arguments,1);t.unshift(this),e.apply(this,t)},e.Store=function(){this.store={},this.length=0},e.Store.load=function(t){var n=new this;return n.length=t.length,n.store=Object.keys(t.store).reduce(function(n,r){return n[r]=e.SortedSet.load(t.store[r]),n},{}),n},e.Store.prototype.set=function(e,t){this.has(e)||this.length++,this.store[e]=t},e.Store.prototype.get=function(e){return this.store[e]},e.Store.prototype.has=function(e){return e in this.store},e.Store.prototype.remove=function(e){this.has(e)&&(delete this.store[e],this.length--)},e.Store.prototype.toJSON=function(){return{store:this.store,length:this.length}},e.stemmer=function(){var e={ational:"ate",tional:"tion",enci:"ence",anci:"ance",izer:"ize",bli:"ble",alli:"al",entli:"ent",eli:"e",ousli:"ous",ization:"ize",ation:"ate",ator:"ate",alism:"al",iveness:"ive",fulness:"ful",ousness:"ous",aliti:"al",iviti:"ive",biliti:"ble",logi:"log"},t={icate:"ic",ative:"",alize:"al",iciti:"ic",ical:"ic",ful:"",ness:""},n="[aeiouy]",r="[^aeiou][^aeiouy]*",i=new RegExp("^([^aeiou][^aeiouy]*)?[aeiouy][aeiou]*[^aeiou][^aeiouy]*"),o=new RegExp("^([^aeiou][^aeiouy]*)?[aeiouy][aeiou]*[^aeiou][^aeiouy]*[aeiouy][aeiou]*[^aeiou][^aeiouy]*"),s=new RegExp("^([^aeiou][^aeiouy]*)?[aeiouy][aeiou]*[^aeiou][^aeiouy]*([aeiouy][aeiou]*)?$"),a=new RegExp("^([^aeiou][^aeiouy]*)?[aeiouy]"),u=/^(.+?)(ss|i)es$/,c=/^(.+?)([^s])s$/,l=/^(.+?)eed$/,f=/^(.+?)(ed|ing)$/,d=/.$/,p=/(at|bl|iz)$/,h=new RegExp("([^aeiouylsz])\\1$"),g=new RegExp("^"+r+n+"[^aeiouwxy]$"),v=/^(.+?[^aeiou])y$/,m=/^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/,y=/^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/,x=/^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/,b=/^(.+?)(s|t)(ion)$/,w=/^(.+?)e$/,T=/ll$/,S=new RegExp("^"+r+n+"[^aeiouwxy]$");return function(n){var r,E,C,k,N,j,A;if(n.length<3)return n;if(C=n.substr(0,1),"y"==C&&(n=C.toUpperCase()+n.substr(1)),k=u,N=c,k.test(n)?n=n.replace(k,"$1$2"):N.test(n)&&(n=n.replace(N,"$1$2")),k=l,N=f,k.test(n)){var L=k.exec(n);k=i,k.test(L[1])&&(k=d,n=n.replace(k,""))}else if(N.test(n)){var L=N.exec(n);r=L[1],N=a,N.test(r)&&(n=r,N=p,j=h,A=g,N.test(n)?n+="e":j.test(n)?(k=d,n=n.replace(k,"")):A.test(n)&&(n+="e"))}if(k=v,k.test(n)){var L=k.exec(n);r=L[1],n=r+"i"}if(k=m,k.test(n)){var L=k.exec(n);r=L[1],E=L[2],k=i,k.test(r)&&(n=r+e[E])}if(k=y,k.test(n)){var L=k.exec(n);r=L[1],E=L[2],k=i,k.test(r)&&(n=r+t[E])}if(k=x,N=b,k.test(n)){var L=k.exec(n);r=L[1],k=o,k.test(r)&&(n=r)}else if(N.test(n)){var L=N.exec(n);r=L[1]+L[2],N=o,N.test(r)&&(n=r)}if(k=w,k.test(n)){var L=k.exec(n);r=L[1],k=o,N=s,j=S,(k.test(r)||N.test(r)&&!j.test(r))&&(n=r)}return k=T,N=o,k.test(n)&&N.test(n)&&(k=d,n=n.replace(k,"")),"y"==C&&(n=C.toLowerCase()+n.substr(1)),n}}(),e.Pipeline.registerFunction(e.stemmer,"stemmer"),e.stopWordFilter=function(t){if(-1===e.stopWordFilter.stopWords.indexOf(t))return t},e.stopWordFilter.stopWords=new e.SortedSet,e.stopWordFilter.stopWords.length=119,e.stopWordFilter.stopWords.elements=["","a","able","about","across","after","all","almost","also","am","among","an","and","any","are","as","at","be","because","been","but","by","can","cannot","could","dear","did","do","does","either","else","ever","every","for","from","get","got","had","has","have","he","her","hers","him","his","how","however","i","if","in","into","is","it","its","just","least","let","like","likely","may","me","might","most","must","my","neither","no","nor","not","of","off","often","on","only","or","other","our","own","rather","said","say","says","she","should","since","so","some","than","that","the","their","them","then","there","these","they","this","tis","to","too","twas","us","wants","was","we","were","what","when","where","which","while","who","whom","why","will","with","would","yet","you","your"],e.Pipeline.registerFunction(e.stopWordFilter,"stopWordFilter"),e.trimmer=function(e){return e.replace(/^\W+/,"").replace(/\W+$/,"")},e.Pipeline.registerFunction(e.trimmer,"trimmer"),e.TokenStore=function(){this.root={docs:{}},this.length=0},e.TokenStore.load=function(e){var t=new this;return t.root=e.root,t.length=e.length,t},e.TokenStore.prototype.add=function(e,t,n){var n=n||this.root,r=e[0],i=e.slice(1);return r in n||(n[r]={docs:{}}),0===i.length?(n[r].docs[t.ref]=t,void(this.length+=1)):this.add(i,t,n[r])},e.TokenStore.prototype.has=function(e){if(!e)return!1;for(var t=this.root,n=0;n<e.length;n++){if(!t[e[n]])return!1;t=t[e[n]]}return!0},e.TokenStore.prototype.getNode=function(e){if(!e)return{};for(var t=this.root,n=0;n<e.length;n++){if(!t[e[n]])return{};t=t[e[n]]}return t},e.TokenStore.prototype.get=function(e,t){return this.getNode(e,t).docs||{}},e.TokenStore.prototype.count=function(e,t){return Object.keys(this.get(e,t)).length},e.TokenStore.prototype.remove=function(e,t){if(e){for(var n=this.root,r=0;r<e.length;r++){if(!(e[r]in n))return;n=n[e[r]]}delete n.docs[t]}},e.TokenStore.prototype.expand=function(e,t){var n=this.getNode(e),r=n.docs||{},t=t||[];return Object.keys(r).length&&t.push(e),Object.keys(n).forEach(function(n){"docs"!==n&&t.concat(this.expand(e+n,t))},this),t},e.TokenStore.prototype.toJSON=function(){return{root:this.root,length:this.length}},function(e,t){"function"==typeof define&&define.amd?define(t):"object"==typeof exports?module.exports=t():e.lunr=t()}(this,function(){return e})}(),function(){function e(){}function t(e,t){for(var n=e.length;n--;)if(e[n].listener===t)return n;return-1}function n(e){return function(){return this[e].apply(this,arguments)}}var r=e.prototype,i=this,o=i.EventEmitter;r.getListeners=function(e){var t,n,r=this._getEvents();if("object"==typeof e){t={};for(n in r)r.hasOwnProperty(n)&&e.test(n)&&(t[n]=r[n])}else t=r[e]||(r[e]=[]);return t},r.flattenListeners=function(e){var t,n=[];for(t=0;e.length>t;t+=1)n.push(e[t].listener);return n},r.getListenersAsObject=function(e){var t,n=this.getListeners(e);return n instanceof Array&&(t={},t[e]=n),t||n},r.addListener=function(e,n){var r,i=this.getListenersAsObject(e),o="object"==typeof n;for(r in i)i.hasOwnProperty(r)&&-1===t(i[r],n)&&i[r].push(o?n:{listener:n,once:!1});return this},r.on=n("addListener"),r.addOnceListener=function(e,t){return this.addListener(e,{listener:t,once:!0})},r.once=n("addOnceListener"),r.defineEvent=function(e){return this.getListeners(e),this},r.defineEvents=function(e){for(var t=0;e.length>t;t+=1)this.defineEvent(e[t]);return this},r.removeListener=function(e,n){var r,i,o=this.getListenersAsObject(e);for(i in o)o.hasOwnProperty(i)&&-1!==(r=t(o[i],n))&&o[i].splice(r,1);return this},r.off=n("removeListener"),r.addListeners=function(e,t){return this.manipulateListeners(!1,e,t)},r.removeListeners=function(e,t){return this.manipulateListeners(!0,e,t)},r.manipulateListeners=function(e,t,n){var r,i,o=e?this.removeListener:this.addListener,s=e?this.removeListeners:this.addListeners;if("object"!=typeof t||t instanceof RegExp)for(r=n.length;r--;)o.call(this,t,n[r]);else for(r in t)t.hasOwnProperty(r)&&(i=t[r])&&("function"==typeof i?o.call(this,r,i):s.call(this,r,i));return this},r.removeEvent=function(e){var t,n=typeof e,r=this._getEvents();if("string"===n)delete r[e];else if("object"===n)for(t in r)r.hasOwnProperty(t)&&e.test(t)&&delete r[t];else delete this._events;return this},r.removeAllListeners=n("removeEvent"),r.emitEvent=function(e,t){var n,r,i,o=this.getListenersAsObject(e);for(i in o)if(o.hasOwnProperty(i))for(r=o[i].length;r--;)n=o[i][r],!0===n.once&&this.removeListener(e,n.listener),n.listener.apply(this,t||[])===this._getOnceReturnValue()&&this.removeListener(e,n.listener);return this},r.trigger=n("emitEvent"),r.emit=function(e){var t=Array.prototype.slice.call(arguments,1);return this.emitEvent(e,t)},r.setOnceReturnValue=function(e){return this._onceReturnValue=e,this},r._getOnceReturnValue=function(){return!this.hasOwnProperty("_onceReturnValue")||this._onceReturnValue},r._getEvents=function(){return this._events||(this._events={})},e.noConflict=function(){return i.EventEmitter=o,e},"function"==typeof define&&define.amd?define("eventEmitter/EventEmitter",[],function(){return e}):"object"==typeof module&&module.exports?module.exports=e:this.EventEmitter=e}.call(this),function(e){function t(t){var n=e.event;return n.target=n.target||n.srcElement||t,n}var n=document.documentElement,r=function(){};n.addEventListener?r=function(e,t,n){e.addEventListener(t,n,!1)}:n.attachEvent&&(r=function(e,n,r){e[n+r]=r.handleEvent?function(){var n=t(e);r.handleEvent.call(r,n)}:function(){var n=t(e);r.call(e,n)},e.attachEvent("on"+n,e[n+r])});var i=function(){};n.removeEventListener?i=function(e,t,n){e.removeEventListener(t,n,!1)}:n.detachEvent&&(i=function(e,t,n){e.detachEvent("on"+t,e[t+n]);try{delete e[t+n]}catch(r){e[t+n]=void 0}});var o={bind:r,unbind:i};"function"==typeof define&&define.amd?define("eventie/eventie",o):e.eventie=o}(this),function(e,t){"function"==typeof define&&define.amd?define(["eventEmitter/EventEmitter","eventie/eventie"],function(n,r){return t(e,n,r)}):"object"==typeof exports?module.exports=t(e,require("wolfy87-eventemitter"),require("eventie")):e.imagesLoaded=t(e,e.EventEmitter,e.eventie)}(window,function(e,t,n){function r(e,t){for(var n in t)e[n]=t[n];return e}function i(e){return"[object Array]"===d.call(e)}function o(e){var t=[];if(i(e))t=e;else if("number"==typeof e.length)for(var n=0,r=e.length;r>n;n++)t.push(e[n]);else t.push(e);return t}function s(e,t,n){if(!(this instanceof s))return new s(e,t);"string"==typeof e&&(e=document.querySelectorAll(e)),this.elements=o(e),this.options=r({},this.options),"function"==typeof t?n=t:r(this.options,t),n&&this.on("always",n),this.getImages(),c&&(this.jqDeferred=new c.Deferred);var i=this;setTimeout(function(){i.check()})}function a(e){this.img=e}function u(e){this.src=e,p[e]=this}var c=e.jQuery,l=e.console,f=void 0!==l,d=Object.prototype.toString;s.prototype=new t,s.prototype.options={},s.prototype.getImages=function(){this.images=[];for(var e=0,t=this.elements.length;t>e;e++){var n=this.elements[e];"IMG"===n.nodeName&&this.addImage(n);var r=n.nodeType;if(r&&(1===r||9===r||11===r))for(var i=n.querySelectorAll("img"),o=0,s=i.length;s>o;o++){var a=i[o];this.addImage(a)}}},s.prototype.addImage=function(e){var t=new a(e);this.images.push(t)},s.prototype.check=function(){function e(e,i){return t.options.debug&&f&&l.log("confirm",e,i),t.progress(e),n++,n===r&&t.complete(),!0}var t=this,n=0,r=this.images.length;if(this.hasAnyBroken=!1,!r)return void this.complete();for(var i=0;r>i;i++){var o=this.images[i];o.on("confirm",e),o.check()}},s.prototype.progress=function(e){this.hasAnyBroken=this.hasAnyBroken||!e.isLoaded;var t=this;setTimeout(function(){t.emit("progress",t,e),t.jqDeferred&&t.jqDeferred.notify&&t.jqDeferred.notify(t,e)})},s.prototype.complete=function(){var e=this.hasAnyBroken?"fail":"done";this.isComplete=!0;var t=this;setTimeout(function(){if(t.emit(e,t),t.emit("always",t),t.jqDeferred){var n=t.hasAnyBroken?"reject":"resolve";t.jqDeferred[n](t)}})},c&&(c.fn.imagesLoaded=function(e,t){return new s(this,e,t).jqDeferred.promise(c(this))}),a.prototype=new t,a.prototype.check=function(){var e=p[this.img.src]||new u(this.img.src);if(e.isConfirmed)return void this.confirm(e.isLoaded,"cached was confirmed");if(this.img.complete&&void 0!==this.img.naturalWidth)return void this.confirm(0!==this.img.naturalWidth,"naturalWidth");var t=this;e.on("confirm",function(e,n){return t.confirm(e.isLoaded,n),!0}),e.check()},a.prototype.confirm=function(e,t){this.isLoaded=e,this.emit("confirm",this,t)};var p={};return u.prototype=new t,u.prototype.check=function(){if(!this.isChecked){var e=new Image;n.bind(e,"load",this),n.bind(e,"error",this),e.src=this.src,this.isChecked=!0}},u.prototype.handleEvent=function(e){var t="on"+e.type;this[t]&&this[t](e)},u.prototype.onload=function(e){this.confirm(!0,"onload"),this.unbindProxyEvents(e)},u.prototype.onerror=function(e){this.confirm(!1,"onerror"),this.unbindProxyEvents(e)},u.prototype.confirm=function(e,t){this.isConfirmed=!0,this.isLoaded=e,this.emit("confirm",this,t)},u.prototype.unbindProxyEvents=function(e){n.unbind(e.target,"load",this),n.unbind(e.target,"error",this)},s}),function(){if("ontouchstart"in window){var e,t,n,r,i,o,s={};e=function(e,t){return Math.abs(e[0]-t[0])>5||Math.abs(e[1]-t[1])>5},t=function(e){this.startXY=[e.touches[0].clientX,e.touches[0].clientY],this.threshold=!1},n=function(t){if(this.threshold)return!1;this.threshold=e(this.startXY,[t.touches[0].clientX,t.touches[0].clientY])},r=function(t){if(!this.threshold&&!e(this.startXY,[t.changedTouches[0].clientX,t.changedTouches[0].clientY])){var n=t.changedTouches[0],r=document.createEvent("MouseEvents");r.initMouseEvent("click",!0,!0,window,0,n.screenX,n.screenY,n.clientX,n.clientY,!1,!1,!1,!1,0,null),r.simulated=!0,t.target.dispatchEvent(r)}},i=function(e){var t=Date.now(),n=t-s.time,r=e.clientX,i=e.clientY,a=[Math.abs(s.x-r),Math.abs(s.y-i)],u=o(e.target,"A")||e.target,c=u.nodeName,l="A"===c,f=window.navigator.standalone&&l&&e.target.getAttribute("href");if(s.time=t,s.x=r,s.y=i,(!e.simulated&&(n<500||n<1500&&a[0]<50&&a[1]<50)||f)&&(e.preventDefault(),e.stopPropagation(),!f))return!1;f&&(window.location=u.getAttribute("href")),u&&u.classList&&(u.classList.add("energize-focus"),window.setTimeout(function(){u.classList.remove("energize-focus")},150))},o=function(e,t){for(var n=e;n!==document.body;){if(!n||n.nodeName===t)return n;n=n.parentNode}return null},document.addEventListener("touchstart",t,!1),document.addEventListener("touchmove",n,!1),document.addEventListener("touchend",r,!1),document.addEventListener("click",i,!0)}}(),function(){"use strict";function e(e){if(e&&""!==e){$(".lang-selector a").removeClass("active"),$(".lang-selector a[data-language-name='"+e+"']").addClass("active");for(var t=0;t<a.length;t++)$(".highlight.tab-"+a[t]).hide(),$(".lang-specific."+a[t]).hide();$(".highlight.tab-"+e).show(),$(".lang-specific."+e).show(),window.recacheHeights(),$(window.location.hash).get(0)&&$(window.location.hash).get(0).scrollIntoView(!0)}}function t(e){return"string"!=typeof e?{}:(e=e.trim().replace(/^(\?|#|&)/,""),e?e.split("&").reduce(function(e,t){var n=t.replace(/\+/g," ").split("="),r=n[0],i=n[1];return r=decodeURIComponent(r),i=void 0===i?null:decodeURIComponent(i),e.hasOwnProperty(r)?Array.isArray(e[r])?e[r].push(i):e[r]=[e[r],i]:e[r]=i,e},{}):{})}function n(e){return e?Object.keys(e).sort().map(function(t){var n=e[t];return Array.isArray(n)?n.sort().map(function(e){return encodeURIComponent(t)+"="+encodeURIComponent(e)}).join("&"):encodeURIComponent(t)+"="+encodeURIComponent(n)}).join("&"):""}function r(){if(location.search.length>=1){var e=t(location.search).language;if(e)return e;if(-1!=jQuery.inArray(location.search.substr(1),a))return location.search.substr(1)}return!1}function i(e){var r=t(location.search);return r.language?(r.language=e,n(r)):e}function o(e){if(history){var t=window.location.hash;t&&(t=t.replace(/^#+/,"")),history.pushState({},"","?"+i(e)+"#"+t),localStorage.setItem("language",e)}}function s(t){var n=localStorage.getItem("language");a=t;var i=r();i?(e(i),localStorage.setItem("language",i)):e(null!==n&&-1!=jQuery.inArray(n,a)?n:a[0])}var a=[];window.setupLanguages=s,window.activateLanguage=e,window.getLanguageFromQueryString=r,$(function(){$(".lang-selector a").on("click",function(){var t=$(this).data("language-name");return o(t),e(t),!1})})}(),function(){"use strict";function e(){$("h1, h2").each(function(){var e=$(this),t=e.nextUntil("h1, h2");f.add({id:e.prop("id"),title:e.text(),body:t.text()})}),t()}function t(){f.tokenStore.length>5e3&&(c=300)}function n(){s=$(".content"),a=$(".search-results"),$("#input-search").on("keyup",function(e){!function(){return function(e,t){clearTimeout(l),l=setTimeout(e,t)}}()(function(){r(e)},c)})}function r(e){var t=$("#input-search")[0];if(o(),a.addClass("visible"),27===e.keyCode&&(t.value=""),t.value){var n=f.search(t.value).filter(function(e){return e.score>1e-4});n.length?(a.empty(),$.each(n,function(e,t){var n=document.getElementById(t.ref);a.append("<li><a href='#"+t.ref+"'>"+$(n).text()+"</a></li>")}),i.call(t)):(a.html("<li></li>"),$(".search-results li").text('No Results Found for "'+t.value+'"'))}else o(),a.removeClass("visible")}function i(){this.value&&s.highlight(this.value,u)}function o(){s.unhighlight(u)}var s,a,u={element:"span",className:"search-highlight"},c=0,l=0,f=new lunr.Index;f.ref("id"),f.field("title",{boost:10}),f.field("body"),f.pipeline.add(lunr.trimmer,lunr.stopWordFilter),$(e),$(n)}(),function(){"use strict";function e(e,i,o,s){var a={},u=0,c=0,l=document.title,f=function(){a={},u=$(document).height(),c=$(window).height(),e.find(i).each(function(){var e=$(this).attr("href");"#"===e[0]&&(a[e]=$(e).offset().top)})},d=function(){var n=$(document).scrollTop()+s;n+c>=u&&(n=u+1e3);var r=null;for(var f in a)(a[f]<n&&a[f]>a[r]||null===r)&&(r=f);n!=s||t||(r=window.location.hash,t=!0);var d=e.find("[href='"+r+"']").first();if(!d.hasClass("active")){e.find(".active").removeClass("active"),e.find(".active-parent").removeClass("active-parent"),d.addClass("active"),d.parents(o).addClass("active").siblings(i).addClass("active-parent"),d.siblings(o).addClass("active"),e.find(o).filter(":not(.active)").slideUp(150),e.find(o).filter(".active").slideDown(150),window.history.replaceState&&window.history.replaceState(null,"",r);var p=d.data("title");void 0!==p&&p.length>0?document.title=p+" – "+l:document.title=l}};!function(){f(),d(),$("#nav-button").click(function(){return $(".toc-wrapper").toggleClass("open"),$("#nav-button").toggleClass("open"),!1}),$(".page-wrapper").click(r),$(".toc-link").click(r),e.find(i).click(function(){setTimeout(function(){d()},0)}),$(window).scroll(n(d,200)),$(window).resize(n(f,200))}(),window.recacheHeights=f,window.refreshToc=d}var t=!1,n=function(e,t){var n=!1;return function(){!1===n&&(setTimeout(function(){e(),n=!1},t),n=!0)}},r=function(){$(".toc-wrapper").removeClass("open"),$("#nav-button").removeClass("open")};window.loadToc=e}(),$(function(){loadToc($("#toc"),".toc-link",".toc-list-h2, .toc-list-h3, .toc-list-h4, .toc-list-h5, .toc-list-h6",10),setupLanguages($("body").data("languages")),$(".content").imagesLoaded(function(){window.recacheHeights(),window.refreshToc()})}),window.onpopstate=function(){activateLanguage(getLanguageFromQueryString())};</script>
  1317. <meta name="theme-color" content="#F3F7F9" />
  1318. <!-- Renderer: Shins v2.6.0 -->
  1319. <!-- Generator: Widdershins v4.0.1 -->
  1320. <!-- backwards compatibility -->
  1321. <!-- backwards compatibility -->
  1322. <!-- backwards compatibility -->
  1323. <!-- backwards compatibility -->
  1324. <!-- backwards compatibility -->
  1325. <!-- backwards compatibility -->
  1326. <!-- backwards compatibility -->
  1327. <!-- backwards compatibility -->
  1328. <!-- backwards compatibility -->
  1329. <!-- backwards compatibility -->
  1330. <!-- backwards compatibility -->
  1331. <!-- backwards compatibility -->
  1332. <!-- backwards compatibility -->
  1333. <!-- backwards compatibility -->
  1334. <!-- backwards compatibility -->
  1335. <!-- backwards compatibility -->
  1336. <!-- backwards compatibility -->
  1337. <!-- backwards compatibility -->
  1338. <!-- backwards compatibility -->
  1339. <!-- backwards compatibility -->
  1340. <!-- backwards compatibility -->
  1341. <!-- backwards compatibility -->
  1342. <!-- backwards compatibility -->
  1343. <!-- backwards compatibility -->
  1344. <!-- backwards compatibility -->
  1345. <!-- backwards compatibility -->
  1346. <!-- backwards compatibility -->
  1347. <!-- backwards compatibility -->
  1348. <!-- backwards compatibility -->
  1349. </head>
  1350. <body data-languages="[&quot;shell&quot;,&quot;http&quot;,&quot;javascript&quot;,&quot;javascript--nodejs&quot;,&quot;ruby&quot;,&quot;python&quot;,&quot;java&quot;,&quot;go&quot;,&quot;php&quot;]">
  1351. <a href="#" id="nav-button">
  1352. <span>
  1353. NAV
  1354. <img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAAAAABWESUoAAAAAnRSTlMAAHaTzTgAAAAZSURBVHgBYxgswBIIsLFGrIJRBaMKBh4AAE3cQCEvEU3+AAAAAElFTkSuQmCC" class="undefined" alt="Navigation">
  1355. </span>
  1356. </a>
  1357. <div class="toc-wrapper">
  1358. <img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGEAAAAcCAYAAABxutG8AAAG6klEQVR4Ad3aA4xkSxcA4LvefbZt27Zt27Zt27Zt27bttWe2R9+vTionlZs7760m/5eMutDVXV11T507RUeD7rgAL+AQzIlx/mYfp6OGs4oOAp3QEz3Er65FR4NO2EL0GhZtZ/t50IhWXFJ0EFgDd+LW9OUWHFd0RJgSr4lewGTVbZ2BFjRh16KDwHNKjEynE+MkfIz7MP0o3pJuEQ3FChXtxsdLgEYs+385CVgQ98rVcAy6jaIt6Vq5DSraLYM/AMMxbdFB4NmRmgRMhtXyjgxATXQ7xs37sA7WxQRFBXTDzXLrVLTbXTK0qNbxJwGTYVe8IPoFF2F3fC96BZPnffkG8AQ2ROeKre4JUV8sVd5GL1wn+an4BzAJFsE62Aa7YM1Ubgbsgz2xF3ajOsLBS397ErAj3kKrpBVnYf56nfXQKLqAOCgsjKGSRhyDTiXPPQs+Fb1F+faCKfCJ5NmindAT2+FuvIufMBBNgA8wSb3u/nIzFBVwIHrjN/wqfT2ZV2Z6vI5W0ZdYHF3Svu1EUSO2yvt0DlpEr5etBiyFmuiKihc5q+jqoh1wFP5ETbkfMG+9/pFys9XL5sI9eLH+9TKextToivHlX73SYOiMA+SacTe6xMGbCI+LvsHc+ZbmHbmLyVcCOmMv0WBsWPFmbik6qryuzlgLfbXP95irfBLMXi/bGTW5tYsqmAp3yfXD/iVtZkQ/0XN5PRtgmNxG5eFpNrmfVO27uEy0ZUm9qXGt9mlDA55XDzawG2oYjCFoxLRpC9cgt1bVBIyH5+V+oXwGsZqoBafFOnrgMrkRmKv8oJbZr6iAj0VL53XMibeU+wtP4WIcgm2xERaKF27rSdHemug0spNwhtwgLF/R7lxRA/EwhWnRW+49TF3S76Gi34t2kJsulpsDf8oNwaVYETNgYnQv/gHshMaq0DqDPnJbFBXwiah/EYSlO0h0c1lSDn9Vb1sR5ifKgw0DRV9h62IUwjrohza0og2wUFXDBtEtRQVMJHdffur1AT7EANGRJf1uIXqpaAfsIWpIZSbFx4A2fDSK3/wA3dAT3du9onCHaNLqNraV2yq/ZmjAtaJh2KSk3w8kfbEoZsKyWBiTlLS7RvRlusi7GjAYJ2CidqZmNsEGWBVz5uGwlbEptsYa+YfUWtgOUxVVMDsGp8FXw30yMVWBD/E6zhN9jwVKVsEIyXd4AZ9hdzyBT3EFxottvS96qv74+oBvqE7mYUu8gB9wDn5AX3yHK9ELe+Nb9MYwtOCG1Icd8C4Ghg9nFayEgXi3nfWHi96J5VYA7CgPN9/G+HnKwXOiNsB+GBf3AdrwNWnS0Si6Gl3wM77GHBWvZwI8ghGAlzAefhcthXvktq33c5g4luFhlVTBdNihup755I6JdTyF3zEhfhQ9nPdpczTKDUQnTIpXJc04OJ1xtIgOx8EYWrUCMCmelDThYEyL/qIV8KrcLFgdraIvMFcxqmFfuYVTueVQw26YXtSCU/JknVfk4HJ0wowYKmnD7mnVaRXtiYHYvzpl7lzRX5gSO6MxTo4Z8LXcePgKI0RPolcxquEuUT9MmNIBrsEf6IGlRSOwWezPIcrUUxXYVPSC+ovDrvkkeAYNVUEGFgYgJv5wu+g1dMcg0Yc4Fp/jCUkbLowXe4sVowI+Fj2iHvNjAdSwS/3v7UXDMU88QGlTpn4Bx2eSq0gRDh6Va0Ir7qX8JhMekNseU+FT0Tn1NjXRYxiK9fCBZBi2Kerw3ijZmjBdvsc7AV3RDVfgS/XTME4UDU596YJfAM1oEfXGdDgD8AmWi+OxNP5UDi4oi9flYDysj49QAwzBxhgPTaIG3IS50Srpk7Krlse7xaiAxfBnyZYxH9qwY6rvYtEP6UDjgTRYp+JL0a84AVeU5IHGxVVoUe3IkADMxpadL86uf/UDfIMZMBua5GbBRqKvY6BixWJUwLxxEgzFEuiG9/EEepbngbxVf/wqwGBshe54C/l2VAIn4hR8I6phqNyZmDzF8p6Suwzj437sjAGAF1Mor1n0Qb1sF9Gt6V9d3FiMSnhSMgjr4UH8iWnypJm/JL/gfkA/UsIPW8tdnz+/cXAXTsX0+EpuPfwp9yFewnOYBu+IDsY2uAiLYhBacVk6pGojT8FgddHR6IQrMEsxKmECfJRvHaYrqb8mBojexqwlCbBG0cWYFfPgZPyFrdMtTd/LzYAp8bzc1+kumanxnWQY3k6Bhh8BL+MUXCi3ULol6yvJK7g0vxk16s8L9+ModK6+aeQ03Ied0akiAXYMPsEwSR9cnJ+2HYs38DN6o2+MwGyHj9APt2GyfGU5Cg/gVHSNK9lX+BIroSt2xWW4C5divPiB8xUa8H3MAJf7Fykvx9WyNCXUAAAAAElFTkSuQmCC" class="logo" alt="Logo">
  1359. <div class="lang-selector">
  1360. <a href="#" data-language-name="shell">Shell</a>
  1361. <a href="#" data-language-name="http">HTTP</a>
  1362. <a href="#" data-language-name="javascript">JavaScript</a>
  1363. <a href="#" data-language-name="javascript--nodejs">Node.js</a>
  1364. <a href="#" data-language-name="ruby">Ruby</a>
  1365. <a href="#" data-language-name="python">Python</a>
  1366. <a href="#" data-language-name="java">Java</a>
  1367. <a href="#" data-language-name="go">Go</a>
  1368. <a href="#" data-language-name="php">PHP</a>
  1369. </div>
  1370. <div class="search">
  1371. <input type="text" class="search" id="input-search" placeholder="Search">
  1372. </div>
  1373. <ul class="search-results"></ul>
  1374. <div id="toc" class="toc-list-h1">
  1375. <ul class="toc-list-h1">
  1376. <li>
  1377. <a href="#wekan-rest-api" class="toc-h1 toc-link" data-title="Wekan REST API v6.99">Wekan REST API v6.99</a>
  1378. </li>
  1379. <li>
  1380. <a href="#production-security-concerns" class="toc-h1 toc-link" data-title="Production Security Concerns">Production Security Concerns</a>
  1381. </li>
  1382. <li>
  1383. <a href="#authentication" class="toc-h1 toc-link" data-title="Authentication">Authentication</a>
  1384. </li>
  1385. <li>
  1386. <a href="#wekan-rest-api-login" class="toc-h1 toc-link" data-title="Login">Login</a>
  1387. <ul class="toc-list-h2">
  1388. <li>
  1389. <a href="#login" class="toc-h2 toc-link" data-title="">login</a>
  1390. </li>
  1391. <li>
  1392. <a href="#register" class="toc-h2 toc-link" data-title="">register</a>
  1393. </li>
  1394. </ul>
  1395. </li>
  1396. <li>
  1397. <a href="#wekan-rest-api-boards" class="toc-h1 toc-link" data-title="Boards">Boards</a>
  1398. <ul class="toc-list-h2">
  1399. <li>
  1400. <a href="#get_public_boards" class="toc-h2 toc-link" data-title="">get_public_boards</a>
  1401. </li>
  1402. <li>
  1403. <a href="#new_board" class="toc-h2 toc-link" data-title="">new_board</a>
  1404. </li>
  1405. <li>
  1406. <a href="#get_board" class="toc-h2 toc-link" data-title="">get_board</a>
  1407. </li>
  1408. <li>
  1409. <a href="#delete_board" class="toc-h2 toc-link" data-title="">delete_board</a>
  1410. </li>
  1411. <li>
  1412. <a href="#get_board_attachments" class="toc-h2 toc-link" data-title="">get_board_attachments</a>
  1413. </li>
  1414. <li>
  1415. <a href="#exportjson" class="toc-h2 toc-link" data-title="">exportJson</a>
  1416. </li>
  1417. <li>
  1418. <a href="#add_board_label" class="toc-h2 toc-link" data-title="">add_board_label</a>
  1419. </li>
  1420. <li>
  1421. <a href="#set_board_member_permission" class="toc-h2 toc-link" data-title="">set_board_member_permission</a>
  1422. </li>
  1423. <li>
  1424. <a href="#get_boards_count" class="toc-h2 toc-link" data-title="">get_boards_count</a>
  1425. </li>
  1426. <li>
  1427. <a href="#get_boards_from_user" class="toc-h2 toc-link" data-title="">get_boards_from_user</a>
  1428. </li>
  1429. </ul>
  1430. </li>
  1431. <li>
  1432. <a href="#wekan-rest-api-checklists" class="toc-h1 toc-link" data-title="Checklists">Checklists</a>
  1433. <ul class="toc-list-h2">
  1434. <li>
  1435. <a href="#get_all_checklists" class="toc-h2 toc-link" data-title="">get_all_checklists</a>
  1436. </li>
  1437. <li>
  1438. <a href="#new_checklist" class="toc-h2 toc-link" data-title="">new_checklist</a>
  1439. </li>
  1440. <li>
  1441. <a href="#get_checklist" class="toc-h2 toc-link" data-title="">get_checklist</a>
  1442. </li>
  1443. <li>
  1444. <a href="#delete_checklist" class="toc-h2 toc-link" data-title="">delete_checklist</a>
  1445. </li>
  1446. </ul>
  1447. </li>
  1448. <li>
  1449. <a href="#wekan-rest-api-checklistitems" class="toc-h1 toc-link" data-title="ChecklistItems">ChecklistItems</a>
  1450. <ul class="toc-list-h2">
  1451. <li>
  1452. <a href="#new_checklist_item" class="toc-h2 toc-link" data-title="">new_checklist_item</a>
  1453. </li>
  1454. <li>
  1455. <a href="#get_checklist_item" class="toc-h2 toc-link" data-title="">get_checklist_item</a>
  1456. </li>
  1457. <li>
  1458. <a href="#edit_checklist_item" class="toc-h2 toc-link" data-title="">edit_checklist_item</a>
  1459. </li>
  1460. <li>
  1461. <a href="#delete_checklist_item" class="toc-h2 toc-link" data-title="">delete_checklist_item</a>
  1462. </li>
  1463. </ul>
  1464. </li>
  1465. <li>
  1466. <a href="#wekan-rest-api-cardcomments" class="toc-h1 toc-link" data-title="CardComments">CardComments</a>
  1467. <ul class="toc-list-h2">
  1468. <li>
  1469. <a href="#get_all_comments" class="toc-h2 toc-link" data-title="">get_all_comments</a>
  1470. </li>
  1471. <li>
  1472. <a href="#new_comment" class="toc-h2 toc-link" data-title="">new_comment</a>
  1473. </li>
  1474. <li>
  1475. <a href="#get_comment" class="toc-h2 toc-link" data-title="">get_comment</a>
  1476. </li>
  1477. <li>
  1478. <a href="#delete_comment" class="toc-h2 toc-link" data-title="">delete_comment</a>
  1479. </li>
  1480. </ul>
  1481. </li>
  1482. <li>
  1483. <a href="#wekan-rest-api-cards" class="toc-h1 toc-link" data-title="Cards">Cards</a>
  1484. <ul class="toc-list-h2">
  1485. <li>
  1486. <a href="#get_cards_by_custom_field" class="toc-h2 toc-link" data-title="">get_cards_by_custom_field</a>
  1487. </li>
  1488. <li>
  1489. <a href="#get_board_cards_count" class="toc-h2 toc-link" data-title="">get_board_cards_count</a>
  1490. </li>
  1491. <li>
  1492. <a href="#get_all_cards" class="toc-h2 toc-link" data-title="">get_all_cards</a>
  1493. </li>
  1494. <li>
  1495. <a href="#new_card" class="toc-h2 toc-link" data-title="">new_card</a>
  1496. </li>
  1497. <li>
  1498. <a href="#get_card" class="toc-h2 toc-link" data-title="">get_card</a>
  1499. </li>
  1500. <li>
  1501. <a href="#edit_card" class="toc-h2 toc-link" data-title="">edit_card</a>
  1502. </li>
  1503. <li>
  1504. <a href="#delete_card" class="toc-h2 toc-link" data-title="">delete_card</a>
  1505. </li>
  1506. <li>
  1507. <a href="#edit_card_custom_field" class="toc-h2 toc-link" data-title="">edit_card_custom_field</a>
  1508. </li>
  1509. <li>
  1510. <a href="#get_list_cards_count" class="toc-h2 toc-link" data-title="">get_list_cards_count</a>
  1511. </li>
  1512. <li>
  1513. <a href="#get_swimlane_cards" class="toc-h2 toc-link" data-title="">get_swimlane_cards</a>
  1514. </li>
  1515. </ul>
  1516. </li>
  1517. <li>
  1518. <a href="#wekan-rest-api-customfields" class="toc-h1 toc-link" data-title="CustomFields">CustomFields</a>
  1519. <ul class="toc-list-h2">
  1520. <li>
  1521. <a href="#get_all_custom_fields" class="toc-h2 toc-link" data-title="">get_all_custom_fields</a>
  1522. </li>
  1523. <li>
  1524. <a href="#new_custom_field" class="toc-h2 toc-link" data-title="">new_custom_field</a>
  1525. </li>
  1526. <li>
  1527. <a href="#get_custom_field" class="toc-h2 toc-link" data-title="">get_custom_field</a>
  1528. </li>
  1529. <li>
  1530. <a href="#edit_custom_field" class="toc-h2 toc-link" data-title="">edit_custom_field</a>
  1531. </li>
  1532. <li>
  1533. <a href="#delete_custom_field" class="toc-h2 toc-link" data-title="">delete_custom_field</a>
  1534. </li>
  1535. <li>
  1536. <a href="#add_custom_field_dropdown_items" class="toc-h2 toc-link" data-title="">add_custom_field_dropdown_items</a>
  1537. </li>
  1538. <li>
  1539. <a href="#edit_custom_field_dropdown_item" class="toc-h2 toc-link" data-title="">edit_custom_field_dropdown_item</a>
  1540. </li>
  1541. <li>
  1542. <a href="#delete_custom_field_dropdown_item" class="toc-h2 toc-link" data-title="">delete_custom_field_dropdown_item</a>
  1543. </li>
  1544. </ul>
  1545. </li>
  1546. <li>
  1547. <a href="#wekan-rest-api-integrations" class="toc-h1 toc-link" data-title="Integrations">Integrations</a>
  1548. <ul class="toc-list-h2">
  1549. <li>
  1550. <a href="#get_all_integrations" class="toc-h2 toc-link" data-title="">get_all_integrations</a>
  1551. </li>
  1552. <li>
  1553. <a href="#new_integration" class="toc-h2 toc-link" data-title="">new_integration</a>
  1554. </li>
  1555. <li>
  1556. <a href="#get_integration" class="toc-h2 toc-link" data-title="">get_integration</a>
  1557. </li>
  1558. <li>
  1559. <a href="#edit_integration" class="toc-h2 toc-link" data-title="">edit_integration</a>
  1560. </li>
  1561. <li>
  1562. <a href="#delete_integration" class="toc-h2 toc-link" data-title="">delete_integration</a>
  1563. </li>
  1564. <li>
  1565. <a href="#delete_integration_activities" class="toc-h2 toc-link" data-title="">delete_integration_activities</a>
  1566. </li>
  1567. <li>
  1568. <a href="#new_integration_activities" class="toc-h2 toc-link" data-title="">new_integration_activities</a>
  1569. </li>
  1570. </ul>
  1571. </li>
  1572. <li>
  1573. <a href="#wekan-rest-api-lists" class="toc-h1 toc-link" data-title="Lists">Lists</a>
  1574. <ul class="toc-list-h2">
  1575. <li>
  1576. <a href="#get_all_lists" class="toc-h2 toc-link" data-title="">get_all_lists</a>
  1577. </li>
  1578. <li>
  1579. <a href="#new_list" class="toc-h2 toc-link" data-title="">new_list</a>
  1580. </li>
  1581. <li>
  1582. <a href="#get_list" class="toc-h2 toc-link" data-title="">get_list</a>
  1583. </li>
  1584. <li>
  1585. <a href="#delete_list" class="toc-h2 toc-link" data-title="">delete_list</a>
  1586. </li>
  1587. </ul>
  1588. </li>
  1589. <li>
  1590. <a href="#wekan-rest-api-users" class="toc-h1 toc-link" data-title="Users">Users</a>
  1591. <ul class="toc-list-h2">
  1592. <li>
  1593. <a href="#add_board_member" class="toc-h2 toc-link" data-title="">add_board_member</a>
  1594. </li>
  1595. <li>
  1596. <a href="#remove_board_member" class="toc-h2 toc-link" data-title="">remove_board_member</a>
  1597. </li>
  1598. <li>
  1599. <a href="#create_user_token" class="toc-h2 toc-link" data-title="">create_user_token</a>
  1600. </li>
  1601. <li>
  1602. <a href="#delete_user_token" class="toc-h2 toc-link" data-title="">delete_user_token</a>
  1603. </li>
  1604. <li>
  1605. <a href="#get_current_user" class="toc-h2 toc-link" data-title="">get_current_user</a>
  1606. </li>
  1607. <li>
  1608. <a href="#get_all_users" class="toc-h2 toc-link" data-title="">get_all_users</a>
  1609. </li>
  1610. <li>
  1611. <a href="#new_user" class="toc-h2 toc-link" data-title="">new_user</a>
  1612. </li>
  1613. <li>
  1614. <a href="#get_user" class="toc-h2 toc-link" data-title="">get_user</a>
  1615. </li>
  1616. <li>
  1617. <a href="#edit_user" class="toc-h2 toc-link" data-title="">edit_user</a>
  1618. </li>
  1619. <li>
  1620. <a href="#delete_user" class="toc-h2 toc-link" data-title="">delete_user</a>
  1621. </li>
  1622. </ul>
  1623. </li>
  1624. <li>
  1625. <a href="#wekan-rest-api-swimlanes" class="toc-h1 toc-link" data-title="Swimlanes">Swimlanes</a>
  1626. <ul class="toc-list-h2">
  1627. <li>
  1628. <a href="#get_all_swimlanes" class="toc-h2 toc-link" data-title="">get_all_swimlanes</a>
  1629. </li>
  1630. <li>
  1631. <a href="#new_swimlane" class="toc-h2 toc-link" data-title="">new_swimlane</a>
  1632. </li>
  1633. <li>
  1634. <a href="#get_swimlane" class="toc-h2 toc-link" data-title="">get_swimlane</a>
  1635. </li>
  1636. <li>
  1637. <a href="#edit_swimlane" class="toc-h2 toc-link" data-title="">edit_swimlane</a>
  1638. </li>
  1639. <li>
  1640. <a href="#delete_swimlane" class="toc-h2 toc-link" data-title="">delete_swimlane</a>
  1641. </li>
  1642. </ul>
  1643. </li>
  1644. <li>
  1645. <a href="#schemas" class="toc-h1 toc-link" data-title="Schemas">Schemas</a>
  1646. <ul class="toc-list-h2">
  1647. <li>
  1648. <a href="#tocs_boards" class="toc-h2 toc-link" data-title="">Boards</a>
  1649. </li>
  1650. <li>
  1651. <a href="#tocs_boardslabels" class="toc-h2 toc-link" data-title="">BoardsLabels</a>
  1652. </li>
  1653. <li>
  1654. <a href="#tocs_boardsmembers" class="toc-h2 toc-link" data-title="">BoardsMembers</a>
  1655. </li>
  1656. <li>
  1657. <a href="#tocs_boardsorgs" class="toc-h2 toc-link" data-title="">BoardsOrgs</a>
  1658. </li>
  1659. <li>
  1660. <a href="#tocs_boardsteams" class="toc-h2 toc-link" data-title="">BoardsTeams</a>
  1661. </li>
  1662. <li>
  1663. <a href="#tocs_cardcomments" class="toc-h2 toc-link" data-title="">CardComments</a>
  1664. </li>
  1665. <li>
  1666. <a href="#tocs_cards" class="toc-h2 toc-link" data-title="">Cards</a>
  1667. </li>
  1668. <li>
  1669. <a href="#tocs_cardsvote" class="toc-h2 toc-link" data-title="">CardsVote</a>
  1670. </li>
  1671. <li>
  1672. <a href="#tocs_cardspoker" class="toc-h2 toc-link" data-title="">CardsPoker</a>
  1673. </li>
  1674. <li>
  1675. <a href="#tocs_cardscustomfields" class="toc-h2 toc-link" data-title="">CardsCustomfields</a>
  1676. </li>
  1677. <li>
  1678. <a href="#tocs_checklistitems" class="toc-h2 toc-link" data-title="">ChecklistItems</a>
  1679. </li>
  1680. <li>
  1681. <a href="#tocs_checklists" class="toc-h2 toc-link" data-title="">Checklists</a>
  1682. </li>
  1683. <li>
  1684. <a href="#tocs_customfields" class="toc-h2 toc-link" data-title="">CustomFields</a>
  1685. </li>
  1686. <li>
  1687. <a href="#tocs_customfieldssettings" class="toc-h2 toc-link" data-title="">CustomFieldsSettings</a>
  1688. </li>
  1689. <li>
  1690. <a href="#tocs_customfieldssettingsdropdownitems" class="toc-h2 toc-link" data-title="">CustomFieldsSettingsDropdownitems</a>
  1691. </li>
  1692. <li>
  1693. <a href="#tocs_integrations" class="toc-h2 toc-link" data-title="">Integrations</a>
  1694. </li>
  1695. <li>
  1696. <a href="#tocs_lists" class="toc-h2 toc-link" data-title="">Lists</a>
  1697. </li>
  1698. <li>
  1699. <a href="#tocs_listswiplimit" class="toc-h2 toc-link" data-title="">ListsWiplimit</a>
  1700. </li>
  1701. <li>
  1702. <a href="#tocs_swimlanes" class="toc-h2 toc-link" data-title="">Swimlanes</a>
  1703. </li>
  1704. <li>
  1705. <a href="#tocs_users" class="toc-h2 toc-link" data-title="">Users</a>
  1706. </li>
  1707. <li>
  1708. <a href="#tocs_usersprofile" class="toc-h2 toc-link" data-title="">UsersProfile</a>
  1709. </li>
  1710. <li>
  1711. <a href="#tocs_userssessiondata" class="toc-h2 toc-link" data-title="">UsersSessiondata</a>
  1712. </li>
  1713. <li>
  1714. <a href="#tocs_usersorgs" class="toc-h2 toc-link" data-title="">UsersOrgs</a>
  1715. </li>
  1716. <li>
  1717. <a href="#tocs_usersteams" class="toc-h2 toc-link" data-title="">UsersTeams</a>
  1718. </li>
  1719. <li>
  1720. <a href="#tocs_usersemails" class="toc-h2 toc-link" data-title="">UsersEmails</a>
  1721. </li>
  1722. <li>
  1723. <a href="#tocs_usersprofilemoveandcopydialog" class="toc-h2 toc-link" data-title="">UsersProfileMoveandcopydialog</a>
  1724. </li>
  1725. <li>
  1726. <a href="#tocs_usersprofilemovechecklistdialog" class="toc-h2 toc-link" data-title="">UsersProfileMovechecklistdialog</a>
  1727. </li>
  1728. <li>
  1729. <a href="#tocs_usersprofilecopychecklistdialog" class="toc-h2 toc-link" data-title="">UsersProfileCopychecklistdialog</a>
  1730. </li>
  1731. <li>
  1732. <a href="#tocs_usersprofilenotifications" class="toc-h2 toc-link" data-title="">UsersProfileNotifications</a>
  1733. </li>
  1734. </ul>
  1735. </li>
  1736. </ul>
  1737. </div>
  1738. <ul class="toc-footer">
  1739. </ul>
  1740. </div>
  1741. <div class="page-wrapper">
  1742. <div class="dark-box"></div>
  1743. <div class="content">
  1744. <h1 id="wekan-rest-api">Wekan REST API v6.99</h1>
  1745. <blockquote>
  1746. <p>Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.</p>
  1747. </blockquote>
  1748. <p>The REST API allows you to control and extend Wekan with ease.</p>
  1749. <p>If you are an end-user and not a dev or a tester, <a href="https://github.com/wekan/wekan/issues/new">create an issue</a> to request new APIs.</p>
  1750. <blockquote>
  1751. <p>All API calls in the documentation are made using <code>curl</code>. However, you are free to use Java / Python / PHP / Golang / Ruby / Swift / Objective-C / Rust / Scala / C# or any other programming languages.</p>
  1752. </blockquote>
  1753. <h1 id="production-security-concerns">Production Security Concerns</h1>
  1754. <p>When calling a production Wekan server, ensure it is running via HTTPS and has a valid SSL Certificate. The login method requires you to post your username and password in plaintext, which is why we highly suggest only calling the REST login api over HTTPS. Also, few things to note:</p>
  1755. <ul>
  1756. <li>Only call via HTTPS</li>
  1757. <li>Implement a timed authorization token expiration strategy</li>
  1758. <li>Ensure the calling user only has permissions for what they are calling and no more</li>
  1759. </ul>
  1760. <h1 id="authentication">Authentication</h1>
  1761. <ul>
  1762. <li>API Key (UserSecurity)
  1763. <ul>
  1764. <li>Parameter Name: <strong>Authorization</strong>, in: header.</li>
  1765. </ul>
  1766. </li>
  1767. </ul>
  1768. <h1 id="wekan-rest-api-login">Login</h1>
  1769. <h2 id="login">login</h2>
  1770. <p><a id="opIdlogin"></a></p>
  1771. <blockquote>
  1772. <p>Code samples</p>
  1773. </blockquote>
  1774. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  1775. curl -X POST /users/login \
  1776. -H <span class="hljs-string">&#x27;Content-Type: application/x-www-form-urlencoded&#x27;</span> \
  1777. -H <span class="hljs-string">&#x27;Accept: */*&#x27;</span>
  1778. </code></pre>
  1779. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/users/login</span> <span class="hljs-meta">HTTP/1.1</span>
  1780. <span class="ada">Content-<span class="hljs-keyword">Type</span>: application/x-www-form-urlencoded
  1781. <span class="hljs-keyword">Accept</span>: */*
  1782. </span></code></pre>
  1783. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  1784. &quot;username&quot;: &quot;string&quot;,
  1785. &quot;password&quot;: &quot;pa$$word&quot;
  1786. }&#x27;</span>;
  1787. <span class="hljs-keyword">const</span> headers = {
  1788. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;application/x-www-form-urlencoded&#x27;</span>,
  1789. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;*/*&#x27;</span>
  1790. };
  1791. fetch(<span class="hljs-string">&#x27;/users/login&#x27;</span>,
  1792. {
  1793. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  1794. <span class="hljs-attr">body</span>: inputBody,
  1795. <span class="hljs-attr">headers</span>: headers
  1796. })
  1797. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  1798. <span class="hljs-keyword">return</span> res.json();
  1799. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  1800. <span class="hljs-built_in">console</span>.log(body);
  1801. });
  1802. </code></pre>
  1803. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  1804. <span class="hljs-keyword">const</span> inputBody = {
  1805. <span class="hljs-string">&quot;username&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  1806. <span class="hljs-string">&quot;password&quot;</span>: <span class="hljs-string">&quot;pa$$word&quot;</span>
  1807. };
  1808. <span class="hljs-keyword">const</span> headers = {
  1809. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;application/x-www-form-urlencoded&#x27;</span>,
  1810. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;*/*&#x27;</span>
  1811. };
  1812. fetch(<span class="hljs-string">&#x27;/users/login&#x27;</span>,
  1813. {
  1814. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  1815. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  1816. <span class="hljs-attr">headers</span>: headers
  1817. })
  1818. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  1819. <span class="hljs-keyword">return</span> res.json();
  1820. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  1821. <span class="hljs-built_in">console</span>.log(body);
  1822. });
  1823. </code></pre>
  1824. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  1825. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  1826. headers = {
  1827. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/x-www-form-urlencoded&#x27;</span>,
  1828. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;*/*&#x27;</span>
  1829. }
  1830. result = RestClient.post <span class="hljs-string">&#x27;/users/login&#x27;</span>,
  1831. <span class="hljs-symbol">params:</span> {
  1832. }, <span class="hljs-symbol">headers:</span> headers
  1833. p JSON.parse(result)
  1834. </code></pre>
  1835. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  1836. headers = {
  1837. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;application/x-www-form-urlencoded&#x27;</span>,
  1838. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;*/*&#x27;</span>
  1839. }
  1840. r = requests.post(<span class="hljs-string">&#x27;/users/login&#x27;</span>, headers = headers)
  1841. <span class="hljs-built_in">print</span>(r.json())
  1842. </code></pre>
  1843. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/users/login&quot;</span>);
  1844. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  1845. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  1846. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  1847. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  1848. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  1849. String inputLine;
  1850. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  1851. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  1852. response.append(inputLine);
  1853. }
  1854. in.close();
  1855. System.out.println(response.toString());
  1856. </code></pre>
  1857. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  1858. <span class="hljs-keyword">import</span> (
  1859. <span class="hljs-string">&quot;bytes&quot;</span>
  1860. <span class="hljs-string">&quot;net/http&quot;</span>
  1861. )
  1862. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  1863. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  1864. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/x-www-form-urlencoded&quot;</span>},
  1865. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;*/*&quot;</span>},
  1866. }
  1867. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  1868. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/users/login&quot;</span>, data)
  1869. req.Header = headers
  1870. client := &amp;http.Client{}
  1871. resp, err := client.Do(req)
  1872. <span class="hljs-comment">// ...</span>
  1873. }
  1874. </code></pre>
  1875. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/x-www-form-urlencoded&#x27;</span>,
  1876. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;*/*&#x27;</span>,
  1877. );
  1878. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  1879. <span class="hljs-comment">// Define array of request body.</span>
  1880. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  1881. <span class="hljs-keyword">try</span> {
  1882. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/users/login&#x27;</span>, <span class="hljs-keyword">array</span>(
  1883. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  1884. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  1885. )
  1886. );
  1887. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  1888. }
  1889. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  1890. <span class="hljs-comment">// handle exception or api errors.</span>
  1891. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  1892. }
  1893. <span class="hljs-comment">// ...</span>
  1894. </code></pre>
  1895. <p><code>POST /users/login</code></p>
  1896. <p><em>Login with REST API</em></p>
  1897. <blockquote>
  1898. <p>Body parameter</p>
  1899. </blockquote>
  1900. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">username:</span> <span class="hljs-string">string</span>
  1901. <span class="hljs-attr">password:</span> <span class="hljs-string">pa$$word</span>
  1902. </code></pre>
  1903. <h3 id="login-parameters">Parameters</h3>
  1904. <table>
  1905. <thead>
  1906. <tr>
  1907. <th>Name</th>
  1908. <th>In</th>
  1909. <th>Type</th>
  1910. <th>Required</th>
  1911. <th>Description</th>
  1912. </tr>
  1913. </thead>
  1914. <tbody>
  1915. <tr>
  1916. <td>body</td>
  1917. <td>body</td>
  1918. <td>object</td>
  1919. <td>true</td>
  1920. <td>none</td>
  1921. </tr>
  1922. <tr>
  1923. <td>» username</td>
  1924. <td>body</td>
  1925. <td>string</td>
  1926. <td>true</td>
  1927. <td>Your username</td>
  1928. </tr>
  1929. <tr>
  1930. <td>» password</td>
  1931. <td>body</td>
  1932. <td>string(password)</td>
  1933. <td>true</td>
  1934. <td>Your password</td>
  1935. </tr>
  1936. </tbody>
  1937. </table>
  1938. <blockquote>
  1939. <p>Example responses</p>
  1940. </blockquote>
  1941. <blockquote>
  1942. <p>200 Response</p>
  1943. </blockquote>
  1944. <h3 id="login-responses">Responses</h3>
  1945. <table>
  1946. <thead>
  1947. <tr>
  1948. <th>Status</th>
  1949. <th>Meaning</th>
  1950. <th>Description</th>
  1951. <th>Schema</th>
  1952. </tr>
  1953. </thead>
  1954. <tbody>
  1955. <tr>
  1956. <td>200</td>
  1957. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  1958. <td>Successful authentication</td>
  1959. <td>Inline</td>
  1960. </tr>
  1961. <tr>
  1962. <td>400</td>
  1963. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.5.1">Bad Request</a></td>
  1964. <td>Error in authentication</td>
  1965. <td>Inline</td>
  1966. </tr>
  1967. <tr>
  1968. <td>default</td>
  1969. <td>Default</td>
  1970. <td>Error in authentication</td>
  1971. <td>None</td>
  1972. </tr>
  1973. </tbody>
  1974. </table>
  1975. <h3 id="login-responseschema">Response Schema</h3>
  1976. <p>Status Code <strong>200</strong></p>
  1977. <table>
  1978. <thead>
  1979. <tr>
  1980. <th>Name</th>
  1981. <th>Type</th>
  1982. <th>Required</th>
  1983. <th>Restrictions</th>
  1984. <th>Description</th>
  1985. </tr>
  1986. </thead>
  1987. <tbody>
  1988. <tr>
  1989. <td>» id</td>
  1990. <td>string</td>
  1991. <td>false</td>
  1992. <td>none</td>
  1993. <td>none</td>
  1994. </tr>
  1995. <tr>
  1996. <td>» token</td>
  1997. <td>string</td>
  1998. <td>false</td>
  1999. <td>none</td>
  2000. <td>none</td>
  2001. </tr>
  2002. <tr>
  2003. <td>» tokenExpires</td>
  2004. <td>string</td>
  2005. <td>false</td>
  2006. <td>none</td>
  2007. <td>none</td>
  2008. </tr>
  2009. </tbody>
  2010. </table>
  2011. <p>Status Code <strong>400</strong></p>
  2012. <table>
  2013. <thead>
  2014. <tr>
  2015. <th>Name</th>
  2016. <th>Type</th>
  2017. <th>Required</th>
  2018. <th>Restrictions</th>
  2019. <th>Description</th>
  2020. </tr>
  2021. </thead>
  2022. <tbody>
  2023. <tr>
  2024. <td>» error</td>
  2025. <td>number</td>
  2026. <td>false</td>
  2027. <td>none</td>
  2028. <td>none</td>
  2029. </tr>
  2030. <tr>
  2031. <td>» reason</td>
  2032. <td>string</td>
  2033. <td>false</td>
  2034. <td>none</td>
  2035. <td>none</td>
  2036. </tr>
  2037. </tbody>
  2038. </table>
  2039. <aside class="success">
  2040. This operation does not require authentication
  2041. </aside>
  2042. <h2 id="register">register</h2>
  2043. <p><a id="opIdregister"></a></p>
  2044. <blockquote>
  2045. <p>Code samples</p>
  2046. </blockquote>
  2047. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  2048. curl -X POST /users/register \
  2049. -H <span class="hljs-string">&#x27;Content-Type: application/x-www-form-urlencoded&#x27;</span> \
  2050. -H <span class="hljs-string">&#x27;Accept: */*&#x27;</span>
  2051. </code></pre>
  2052. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/users/register</span> <span class="hljs-meta">HTTP/1.1</span>
  2053. <span class="ada">Content-<span class="hljs-keyword">Type</span>: application/x-www-form-urlencoded
  2054. <span class="hljs-keyword">Accept</span>: */*
  2055. </span></code></pre>
  2056. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  2057. &quot;username&quot;: &quot;string&quot;,
  2058. &quot;password&quot;: &quot;pa$$word&quot;,
  2059. &quot;email&quot;: &quot;string&quot;
  2060. }&#x27;</span>;
  2061. <span class="hljs-keyword">const</span> headers = {
  2062. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;application/x-www-form-urlencoded&#x27;</span>,
  2063. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;*/*&#x27;</span>
  2064. };
  2065. fetch(<span class="hljs-string">&#x27;/users/register&#x27;</span>,
  2066. {
  2067. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  2068. <span class="hljs-attr">body</span>: inputBody,
  2069. <span class="hljs-attr">headers</span>: headers
  2070. })
  2071. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  2072. <span class="hljs-keyword">return</span> res.json();
  2073. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  2074. <span class="hljs-built_in">console</span>.log(body);
  2075. });
  2076. </code></pre>
  2077. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  2078. <span class="hljs-keyword">const</span> inputBody = {
  2079. <span class="hljs-string">&quot;username&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  2080. <span class="hljs-string">&quot;password&quot;</span>: <span class="hljs-string">&quot;pa$$word&quot;</span>,
  2081. <span class="hljs-string">&quot;email&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  2082. };
  2083. <span class="hljs-keyword">const</span> headers = {
  2084. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;application/x-www-form-urlencoded&#x27;</span>,
  2085. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;*/*&#x27;</span>
  2086. };
  2087. fetch(<span class="hljs-string">&#x27;/users/register&#x27;</span>,
  2088. {
  2089. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  2090. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  2091. <span class="hljs-attr">headers</span>: headers
  2092. })
  2093. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  2094. <span class="hljs-keyword">return</span> res.json();
  2095. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  2096. <span class="hljs-built_in">console</span>.log(body);
  2097. });
  2098. </code></pre>
  2099. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  2100. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  2101. headers = {
  2102. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/x-www-form-urlencoded&#x27;</span>,
  2103. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;*/*&#x27;</span>
  2104. }
  2105. result = RestClient.post <span class="hljs-string">&#x27;/users/register&#x27;</span>,
  2106. <span class="hljs-symbol">params:</span> {
  2107. }, <span class="hljs-symbol">headers:</span> headers
  2108. p JSON.parse(result)
  2109. </code></pre>
  2110. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  2111. headers = {
  2112. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;application/x-www-form-urlencoded&#x27;</span>,
  2113. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;*/*&#x27;</span>
  2114. }
  2115. r = requests.post(<span class="hljs-string">&#x27;/users/register&#x27;</span>, headers = headers)
  2116. <span class="hljs-built_in">print</span>(r.json())
  2117. </code></pre>
  2118. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/users/register&quot;</span>);
  2119. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  2120. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  2121. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  2122. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  2123. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  2124. String inputLine;
  2125. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  2126. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  2127. response.append(inputLine);
  2128. }
  2129. in.close();
  2130. System.out.println(response.toString());
  2131. </code></pre>
  2132. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  2133. <span class="hljs-keyword">import</span> (
  2134. <span class="hljs-string">&quot;bytes&quot;</span>
  2135. <span class="hljs-string">&quot;net/http&quot;</span>
  2136. )
  2137. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  2138. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  2139. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/x-www-form-urlencoded&quot;</span>},
  2140. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;*/*&quot;</span>},
  2141. }
  2142. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  2143. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/users/register&quot;</span>, data)
  2144. req.Header = headers
  2145. client := &amp;http.Client{}
  2146. resp, err := client.Do(req)
  2147. <span class="hljs-comment">// ...</span>
  2148. }
  2149. </code></pre>
  2150. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/x-www-form-urlencoded&#x27;</span>,
  2151. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;*/*&#x27;</span>,
  2152. );
  2153. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  2154. <span class="hljs-comment">// Define array of request body.</span>
  2155. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  2156. <span class="hljs-keyword">try</span> {
  2157. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/users/register&#x27;</span>, <span class="hljs-keyword">array</span>(
  2158. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  2159. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  2160. )
  2161. );
  2162. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  2163. }
  2164. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  2165. <span class="hljs-comment">// handle exception or api errors.</span>
  2166. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  2167. }
  2168. <span class="hljs-comment">// ...</span>
  2169. </code></pre>
  2170. <p><code>POST /users/register</code></p>
  2171. <p><em>Register with REST API</em></p>
  2172. <p>Notes:</p>
  2173. <ul>
  2174. <li>You will need to provide the token for any of the authenticated methods.</li>
  2175. </ul>
  2176. <blockquote>
  2177. <p>Body parameter</p>
  2178. </blockquote>
  2179. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">username:</span> <span class="hljs-string">string</span>
  2180. <span class="hljs-attr">password:</span> <span class="hljs-string">pa$$word</span>
  2181. <span class="hljs-attr">email:</span> <span class="hljs-string">string</span>
  2182. </code></pre>
  2183. <h3 id="register-parameters">Parameters</h3>
  2184. <table>
  2185. <thead>
  2186. <tr>
  2187. <th>Name</th>
  2188. <th>In</th>
  2189. <th>Type</th>
  2190. <th>Required</th>
  2191. <th>Description</th>
  2192. </tr>
  2193. </thead>
  2194. <tbody>
  2195. <tr>
  2196. <td>body</td>
  2197. <td>body</td>
  2198. <td>object</td>
  2199. <td>true</td>
  2200. <td>none</td>
  2201. </tr>
  2202. <tr>
  2203. <td>» username</td>
  2204. <td>body</td>
  2205. <td>string</td>
  2206. <td>true</td>
  2207. <td>Your username</td>
  2208. </tr>
  2209. <tr>
  2210. <td>» password</td>
  2211. <td>body</td>
  2212. <td>string(password)</td>
  2213. <td>true</td>
  2214. <td>Your password</td>
  2215. </tr>
  2216. <tr>
  2217. <td>» email</td>
  2218. <td>body</td>
  2219. <td>string</td>
  2220. <td>true</td>
  2221. <td>Your email</td>
  2222. </tr>
  2223. </tbody>
  2224. </table>
  2225. <blockquote>
  2226. <p>Example responses</p>
  2227. </blockquote>
  2228. <blockquote>
  2229. <p>200 Response</p>
  2230. </blockquote>
  2231. <h3 id="register-responses">Responses</h3>
  2232. <table>
  2233. <thead>
  2234. <tr>
  2235. <th>Status</th>
  2236. <th>Meaning</th>
  2237. <th>Description</th>
  2238. <th>Schema</th>
  2239. </tr>
  2240. </thead>
  2241. <tbody>
  2242. <tr>
  2243. <td>200</td>
  2244. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  2245. <td>Successful registration</td>
  2246. <td>Inline</td>
  2247. </tr>
  2248. <tr>
  2249. <td>400</td>
  2250. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.5.1">Bad Request</a></td>
  2251. <td>Error in registration</td>
  2252. <td>Inline</td>
  2253. </tr>
  2254. <tr>
  2255. <td>default</td>
  2256. <td>Default</td>
  2257. <td>Error in registration</td>
  2258. <td>None</td>
  2259. </tr>
  2260. </tbody>
  2261. </table>
  2262. <h3 id="register-responseschema">Response Schema</h3>
  2263. <p>Status Code <strong>200</strong></p>
  2264. <table>
  2265. <thead>
  2266. <tr>
  2267. <th>Name</th>
  2268. <th>Type</th>
  2269. <th>Required</th>
  2270. <th>Restrictions</th>
  2271. <th>Description</th>
  2272. </tr>
  2273. </thead>
  2274. <tbody>
  2275. <tr>
  2276. <td>» id</td>
  2277. <td>string</td>
  2278. <td>false</td>
  2279. <td>none</td>
  2280. <td>none</td>
  2281. </tr>
  2282. <tr>
  2283. <td>» token</td>
  2284. <td>string</td>
  2285. <td>false</td>
  2286. <td>none</td>
  2287. <td>none</td>
  2288. </tr>
  2289. <tr>
  2290. <td>» tokenExpires</td>
  2291. <td>string</td>
  2292. <td>false</td>
  2293. <td>none</td>
  2294. <td>none</td>
  2295. </tr>
  2296. </tbody>
  2297. </table>
  2298. <p>Status Code <strong>400</strong></p>
  2299. <table>
  2300. <thead>
  2301. <tr>
  2302. <th>Name</th>
  2303. <th>Type</th>
  2304. <th>Required</th>
  2305. <th>Restrictions</th>
  2306. <th>Description</th>
  2307. </tr>
  2308. </thead>
  2309. <tbody>
  2310. <tr>
  2311. <td>» error</td>
  2312. <td>number</td>
  2313. <td>false</td>
  2314. <td>none</td>
  2315. <td>none</td>
  2316. </tr>
  2317. <tr>
  2318. <td>» reason</td>
  2319. <td>string</td>
  2320. <td>false</td>
  2321. <td>none</td>
  2322. <td>none</td>
  2323. </tr>
  2324. </tbody>
  2325. </table>
  2326. <aside class="success">
  2327. This operation does not require authentication
  2328. </aside>
  2329. <h1 id="wekan-rest-api-boards">Boards</h1>
  2330. <h2 id="get_public_boards">get_public_boards</h2>
  2331. <p><a id="opIdget_public_boards"></a></p>
  2332. <blockquote>
  2333. <p>Code samples</p>
  2334. </blockquote>
  2335. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  2336. curl -X GET /api/boards \
  2337. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  2338. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  2339. </code></pre>
  2340. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards</span> <span class="hljs-meta">HTTP/1.1</span>
  2341. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  2342. </span></code></pre>
  2343. <pre class="highlight tab tab-javascript"><code>
  2344. <span class="hljs-keyword">const</span> headers = {
  2345. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  2346. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  2347. };
  2348. fetch(<span class="hljs-string">&#x27;/api/boards&#x27;</span>,
  2349. {
  2350. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  2351. <span class="hljs-attr">headers</span>: headers
  2352. })
  2353. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  2354. <span class="hljs-keyword">return</span> res.json();
  2355. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  2356. <span class="hljs-built_in">console</span>.log(body);
  2357. });
  2358. </code></pre>
  2359. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  2360. <span class="hljs-keyword">const</span> headers = {
  2361. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  2362. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  2363. };
  2364. fetch(<span class="hljs-string">&#x27;/api/boards&#x27;</span>,
  2365. {
  2366. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  2367. <span class="hljs-attr">headers</span>: headers
  2368. })
  2369. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  2370. <span class="hljs-keyword">return</span> res.json();
  2371. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  2372. <span class="hljs-built_in">console</span>.log(body);
  2373. });
  2374. </code></pre>
  2375. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  2376. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  2377. headers = {
  2378. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  2379. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  2380. }
  2381. result = RestClient.get <span class="hljs-string">&#x27;/api/boards&#x27;</span>,
  2382. <span class="hljs-symbol">params:</span> {
  2383. }, <span class="hljs-symbol">headers:</span> headers
  2384. p JSON.parse(result)
  2385. </code></pre>
  2386. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  2387. headers = {
  2388. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  2389. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  2390. }
  2391. r = requests.get(<span class="hljs-string">&#x27;/api/boards&#x27;</span>, headers = headers)
  2392. <span class="hljs-built_in">print</span>(r.json())
  2393. </code></pre>
  2394. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards&quot;</span>);
  2395. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  2396. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  2397. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  2398. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  2399. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  2400. String inputLine;
  2401. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  2402. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  2403. response.append(inputLine);
  2404. }
  2405. in.close();
  2406. System.out.println(response.toString());
  2407. </code></pre>
  2408. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  2409. <span class="hljs-keyword">import</span> (
  2410. <span class="hljs-string">&quot;bytes&quot;</span>
  2411. <span class="hljs-string">&quot;net/http&quot;</span>
  2412. )
  2413. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  2414. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  2415. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  2416. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  2417. }
  2418. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  2419. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards&quot;</span>, data)
  2420. req.Header = headers
  2421. client := &amp;http.Client{}
  2422. resp, err := client.Do(req)
  2423. <span class="hljs-comment">// ...</span>
  2424. }
  2425. </code></pre>
  2426. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  2427. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  2428. );
  2429. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  2430. <span class="hljs-comment">// Define array of request body.</span>
  2431. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  2432. <span class="hljs-keyword">try</span> {
  2433. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards&#x27;</span>, <span class="hljs-keyword">array</span>(
  2434. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  2435. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  2436. )
  2437. );
  2438. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  2439. }
  2440. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  2441. <span class="hljs-comment">// handle exception or api errors.</span>
  2442. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  2443. }
  2444. <span class="hljs-comment">// ...</span>
  2445. </code></pre>
  2446. <p><code>GET /api/boards</code></p>
  2447. <p><em>Get all public boards</em></p>
  2448. <blockquote>
  2449. <p>Example responses</p>
  2450. </blockquote>
  2451. <blockquote>
  2452. <p>200 Response</p>
  2453. </blockquote>
  2454. <pre class="highlight tab tab-json"><code>[
  2455. {
  2456. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  2457. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  2458. }
  2459. ]
  2460. </code></pre>
  2461. <h3 id="get_public_boards-responses">Responses</h3>
  2462. <table>
  2463. <thead>
  2464. <tr>
  2465. <th>Status</th>
  2466. <th>Meaning</th>
  2467. <th>Description</th>
  2468. <th>Schema</th>
  2469. </tr>
  2470. </thead>
  2471. <tbody>
  2472. <tr>
  2473. <td>200</td>
  2474. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  2475. <td>200 response</td>
  2476. <td>Inline</td>
  2477. </tr>
  2478. </tbody>
  2479. </table>
  2480. <h3 id="get_public_boards-responseschema">Response Schema</h3>
  2481. <p>Status Code <strong>200</strong></p>
  2482. <table>
  2483. <thead>
  2484. <tr>
  2485. <th>Name</th>
  2486. <th>Type</th>
  2487. <th>Required</th>
  2488. <th>Restrictions</th>
  2489. <th>Description</th>
  2490. </tr>
  2491. </thead>
  2492. <tbody>
  2493. <tr>
  2494. <td>» _id</td>
  2495. <td>string</td>
  2496. <td>false</td>
  2497. <td>none</td>
  2498. <td>none</td>
  2499. </tr>
  2500. <tr>
  2501. <td>» title</td>
  2502. <td>string</td>
  2503. <td>false</td>
  2504. <td>none</td>
  2505. <td>none</td>
  2506. </tr>
  2507. </tbody>
  2508. </table>
  2509. <aside class="warning">
  2510. To perform this operation, you must be authenticated by means of one of the following methods:
  2511. UserSecurity
  2512. </aside>
  2513. <h2 id="new_board">new_board</h2>
  2514. <p><a id="opIdnew_board"></a></p>
  2515. <blockquote>
  2516. <p>Code samples</p>
  2517. </blockquote>
  2518. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  2519. curl -X POST /api/boards \
  2520. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  2521. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  2522. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  2523. </code></pre>
  2524. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/boards</span> <span class="hljs-meta">HTTP/1.1</span>
  2525. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  2526. Accept: application/json
  2527. </span></code></pre>
  2528. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  2529. &quot;title&quot;: &quot;string&quot;,
  2530. &quot;owner&quot;: &quot;string&quot;,
  2531. &quot;isAdmin&quot;: true,
  2532. &quot;isActive&quot;: true,
  2533. &quot;isNoComments&quot;: true,
  2534. &quot;isCommentOnly&quot;: true,
  2535. &quot;isWorker&quot;: true,
  2536. &quot;permission&quot;: &quot;string&quot;,
  2537. &quot;color&quot;: &quot;string&quot;
  2538. }&#x27;</span>;
  2539. <span class="hljs-keyword">const</span> headers = {
  2540. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  2541. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  2542. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  2543. };
  2544. fetch(<span class="hljs-string">&#x27;/api/boards&#x27;</span>,
  2545. {
  2546. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  2547. <span class="hljs-attr">body</span>: inputBody,
  2548. <span class="hljs-attr">headers</span>: headers
  2549. })
  2550. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  2551. <span class="hljs-keyword">return</span> res.json();
  2552. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  2553. <span class="hljs-built_in">console</span>.log(body);
  2554. });
  2555. </code></pre>
  2556. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  2557. <span class="hljs-keyword">const</span> inputBody = {
  2558. <span class="hljs-string">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  2559. <span class="hljs-string">&quot;owner&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  2560. <span class="hljs-string">&quot;isAdmin&quot;</span>: <span class="hljs-literal">true</span>,
  2561. <span class="hljs-string">&quot;isActive&quot;</span>: <span class="hljs-literal">true</span>,
  2562. <span class="hljs-string">&quot;isNoComments&quot;</span>: <span class="hljs-literal">true</span>,
  2563. <span class="hljs-string">&quot;isCommentOnly&quot;</span>: <span class="hljs-literal">true</span>,
  2564. <span class="hljs-string">&quot;isWorker&quot;</span>: <span class="hljs-literal">true</span>,
  2565. <span class="hljs-string">&quot;permission&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  2566. <span class="hljs-string">&quot;color&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  2567. };
  2568. <span class="hljs-keyword">const</span> headers = {
  2569. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  2570. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  2571. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  2572. };
  2573. fetch(<span class="hljs-string">&#x27;/api/boards&#x27;</span>,
  2574. {
  2575. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  2576. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  2577. <span class="hljs-attr">headers</span>: headers
  2578. })
  2579. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  2580. <span class="hljs-keyword">return</span> res.json();
  2581. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  2582. <span class="hljs-built_in">console</span>.log(body);
  2583. });
  2584. </code></pre>
  2585. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  2586. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  2587. headers = {
  2588. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  2589. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  2590. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  2591. }
  2592. result = RestClient.post <span class="hljs-string">&#x27;/api/boards&#x27;</span>,
  2593. <span class="hljs-symbol">params:</span> {
  2594. }, <span class="hljs-symbol">headers:</span> headers
  2595. p JSON.parse(result)
  2596. </code></pre>
  2597. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  2598. headers = {
  2599. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  2600. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  2601. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  2602. }
  2603. r = requests.post(<span class="hljs-string">&#x27;/api/boards&#x27;</span>, headers = headers)
  2604. <span class="hljs-built_in">print</span>(r.json())
  2605. </code></pre>
  2606. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards&quot;</span>);
  2607. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  2608. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  2609. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  2610. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  2611. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  2612. String inputLine;
  2613. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  2614. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  2615. response.append(inputLine);
  2616. }
  2617. in.close();
  2618. System.out.println(response.toString());
  2619. </code></pre>
  2620. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  2621. <span class="hljs-keyword">import</span> (
  2622. <span class="hljs-string">&quot;bytes&quot;</span>
  2623. <span class="hljs-string">&quot;net/http&quot;</span>
  2624. )
  2625. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  2626. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  2627. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  2628. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  2629. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  2630. }
  2631. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  2632. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/boards&quot;</span>, data)
  2633. req.Header = headers
  2634. client := &amp;http.Client{}
  2635. resp, err := client.Do(req)
  2636. <span class="hljs-comment">// ...</span>
  2637. }
  2638. </code></pre>
  2639. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  2640. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  2641. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  2642. );
  2643. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  2644. <span class="hljs-comment">// Define array of request body.</span>
  2645. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  2646. <span class="hljs-keyword">try</span> {
  2647. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/boards&#x27;</span>, <span class="hljs-keyword">array</span>(
  2648. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  2649. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  2650. )
  2651. );
  2652. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  2653. }
  2654. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  2655. <span class="hljs-comment">// handle exception or api errors.</span>
  2656. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  2657. }
  2658. <span class="hljs-comment">// ...</span>
  2659. </code></pre>
  2660. <p><code>POST /api/boards</code></p>
  2661. <p><em>Create a board</em></p>
  2662. <p>This allows to create a board.</p>
  2663. <p>The color has to be chosen between <code>belize</code>, <code>nephritis</code>, <code>pomegranate</code>,
  2664. <code>pumpkin</code>, <code>wisteria</code>, <code>moderatepink</code>, <code>strongcyan</code>,
  2665. <code>limegreen</code>, <code>midnight</code>, <code>dark</code>, <code>relax</code>, <code>corteza</code>:</p>
  2666. <img src="https://wekan.github.io/board-colors.png" alt="Wekan logo" />
  2667. <blockquote>
  2668. <p>Body parameter</p>
  2669. </blockquote>
  2670. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">title:</span> <span class="hljs-string">string</span>
  2671. <span class="hljs-attr">owner:</span> <span class="hljs-string">string</span>
  2672. <span class="hljs-attr">isAdmin:</span> <span class="hljs-literal">true</span>
  2673. <span class="hljs-attr">isActive:</span> <span class="hljs-literal">true</span>
  2674. <span class="hljs-attr">isNoComments:</span> <span class="hljs-literal">true</span>
  2675. <span class="hljs-attr">isCommentOnly:</span> <span class="hljs-literal">true</span>
  2676. <span class="hljs-attr">isWorker:</span> <span class="hljs-literal">true</span>
  2677. <span class="hljs-attr">permission:</span> <span class="hljs-string">string</span>
  2678. <span class="hljs-attr">color:</span> <span class="hljs-string">string</span>
  2679. </code></pre>
  2680. <h3 id="new_board-parameters">Parameters</h3>
  2681. <table>
  2682. <thead>
  2683. <tr>
  2684. <th>Name</th>
  2685. <th>In</th>
  2686. <th>Type</th>
  2687. <th>Required</th>
  2688. <th>Description</th>
  2689. </tr>
  2690. </thead>
  2691. <tbody>
  2692. <tr>
  2693. <td>body</td>
  2694. <td>body</td>
  2695. <td>object</td>
  2696. <td>true</td>
  2697. <td>none</td>
  2698. </tr>
  2699. <tr>
  2700. <td>» title</td>
  2701. <td>body</td>
  2702. <td>string</td>
  2703. <td>true</td>
  2704. <td>the new title of the board</td>
  2705. </tr>
  2706. <tr>
  2707. <td>» owner</td>
  2708. <td>body</td>
  2709. <td>string</td>
  2710. <td>true</td>
  2711. <td>&quot;ABCDE12345&quot; &lt;= User ID in Wekan.</td>
  2712. </tr>
  2713. <tr>
  2714. <td>» isAdmin</td>
  2715. <td>body</td>
  2716. <td>boolean</td>
  2717. <td>false</td>
  2718. <td>is the owner an admin of the board (default true)</td>
  2719. </tr>
  2720. <tr>
  2721. <td>» isActive</td>
  2722. <td>body</td>
  2723. <td>boolean</td>
  2724. <td>false</td>
  2725. <td>is the board active (default true)</td>
  2726. </tr>
  2727. <tr>
  2728. <td>» isNoComments</td>
  2729. <td>body</td>
  2730. <td>boolean</td>
  2731. <td>false</td>
  2732. <td>disable comments (default false)</td>
  2733. </tr>
  2734. <tr>
  2735. <td>» isCommentOnly</td>
  2736. <td>body</td>
  2737. <td>boolean</td>
  2738. <td>false</td>
  2739. <td>only enable comments (default false)</td>
  2740. </tr>
  2741. <tr>
  2742. <td>» isWorker</td>
  2743. <td>body</td>
  2744. <td>boolean</td>
  2745. <td>false</td>
  2746. <td>only move cards, assign himself to card and comment (default false)</td>
  2747. </tr>
  2748. <tr>
  2749. <td>» permission</td>
  2750. <td>body</td>
  2751. <td>string</td>
  2752. <td>false</td>
  2753. <td>&quot;private&quot; board &lt;== Set to &quot;public&quot; if you</td>
  2754. </tr>
  2755. <tr>
  2756. <td>» color</td>
  2757. <td>body</td>
  2758. <td>string</td>
  2759. <td>false</td>
  2760. <td>the color of the board</td>
  2761. </tr>
  2762. </tbody>
  2763. </table>
  2764. <h4 id="detailed-descriptions">Detailed descriptions</h4>
  2765. <p><strong>» owner</strong>: &quot;ABCDE12345&quot; &lt;= User ID in Wekan.
  2766. (Not username or email)</p>
  2767. <p><strong>» permission</strong>: &quot;private&quot; board &lt;== Set to &quot;public&quot; if you
  2768. want public Wekan board</p>
  2769. <blockquote>
  2770. <p>Example responses</p>
  2771. </blockquote>
  2772. <blockquote>
  2773. <p>200 Response</p>
  2774. </blockquote>
  2775. <pre class="highlight tab tab-json"><code>{
  2776. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  2777. <span class="hljs-attr">&quot;defaultSwimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  2778. }
  2779. </code></pre>
  2780. <h3 id="new_board-responses">Responses</h3>
  2781. <table>
  2782. <thead>
  2783. <tr>
  2784. <th>Status</th>
  2785. <th>Meaning</th>
  2786. <th>Description</th>
  2787. <th>Schema</th>
  2788. </tr>
  2789. </thead>
  2790. <tbody>
  2791. <tr>
  2792. <td>200</td>
  2793. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  2794. <td>200 response</td>
  2795. <td>Inline</td>
  2796. </tr>
  2797. </tbody>
  2798. </table>
  2799. <h3 id="new_board-responseschema">Response Schema</h3>
  2800. <p>Status Code <strong>200</strong></p>
  2801. <table>
  2802. <thead>
  2803. <tr>
  2804. <th>Name</th>
  2805. <th>Type</th>
  2806. <th>Required</th>
  2807. <th>Restrictions</th>
  2808. <th>Description</th>
  2809. </tr>
  2810. </thead>
  2811. <tbody>
  2812. <tr>
  2813. <td>» _id</td>
  2814. <td>string</td>
  2815. <td>false</td>
  2816. <td>none</td>
  2817. <td>none</td>
  2818. </tr>
  2819. <tr>
  2820. <td>» defaultSwimlaneId</td>
  2821. <td>string</td>
  2822. <td>false</td>
  2823. <td>none</td>
  2824. <td>none</td>
  2825. </tr>
  2826. </tbody>
  2827. </table>
  2828. <aside class="warning">
  2829. To perform this operation, you must be authenticated by means of one of the following methods:
  2830. UserSecurity
  2831. </aside>
  2832. <h2 id="get_board">get_board</h2>
  2833. <p><a id="opIdget_board"></a></p>
  2834. <blockquote>
  2835. <p>Code samples</p>
  2836. </blockquote>
  2837. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  2838. curl -X GET /api/boards/{board} \
  2839. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  2840. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  2841. </code></pre>
  2842. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}</span> <span class="hljs-meta">HTTP/1.1</span>
  2843. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  2844. </span></code></pre>
  2845. <pre class="highlight tab tab-javascript"><code>
  2846. <span class="hljs-keyword">const</span> headers = {
  2847. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  2848. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  2849. };
  2850. fetch(<span class="hljs-string">&#x27;/api/boards/{board}&#x27;</span>,
  2851. {
  2852. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  2853. <span class="hljs-attr">headers</span>: headers
  2854. })
  2855. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  2856. <span class="hljs-keyword">return</span> res.json();
  2857. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  2858. <span class="hljs-built_in">console</span>.log(body);
  2859. });
  2860. </code></pre>
  2861. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  2862. <span class="hljs-keyword">const</span> headers = {
  2863. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  2864. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  2865. };
  2866. fetch(<span class="hljs-string">&#x27;/api/boards/{board}&#x27;</span>,
  2867. {
  2868. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  2869. <span class="hljs-attr">headers</span>: headers
  2870. })
  2871. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  2872. <span class="hljs-keyword">return</span> res.json();
  2873. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  2874. <span class="hljs-built_in">console</span>.log(body);
  2875. });
  2876. </code></pre>
  2877. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  2878. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  2879. headers = {
  2880. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  2881. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  2882. }
  2883. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}&#x27;</span>,
  2884. <span class="hljs-symbol">params:</span> {
  2885. }, <span class="hljs-symbol">headers:</span> headers
  2886. p JSON.parse(result)
  2887. </code></pre>
  2888. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  2889. headers = {
  2890. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  2891. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  2892. }
  2893. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}&#x27;</span>, headers = headers)
  2894. <span class="hljs-built_in">print</span>(r.json())
  2895. </code></pre>
  2896. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}&quot;</span>);
  2897. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  2898. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  2899. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  2900. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  2901. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  2902. String inputLine;
  2903. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  2904. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  2905. response.append(inputLine);
  2906. }
  2907. in.close();
  2908. System.out.println(response.toString());
  2909. </code></pre>
  2910. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  2911. <span class="hljs-keyword">import</span> (
  2912. <span class="hljs-string">&quot;bytes&quot;</span>
  2913. <span class="hljs-string">&quot;net/http&quot;</span>
  2914. )
  2915. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  2916. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  2917. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  2918. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  2919. }
  2920. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  2921. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}&quot;</span>, data)
  2922. req.Header = headers
  2923. client := &amp;http.Client{}
  2924. resp, err := client.Do(req)
  2925. <span class="hljs-comment">// ...</span>
  2926. }
  2927. </code></pre>
  2928. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  2929. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  2930. );
  2931. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  2932. <span class="hljs-comment">// Define array of request body.</span>
  2933. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  2934. <span class="hljs-keyword">try</span> {
  2935. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}&#x27;</span>, <span class="hljs-keyword">array</span>(
  2936. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  2937. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  2938. )
  2939. );
  2940. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  2941. }
  2942. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  2943. <span class="hljs-comment">// handle exception or api errors.</span>
  2944. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  2945. }
  2946. <span class="hljs-comment">// ...</span>
  2947. </code></pre>
  2948. <p><code>GET /api/boards/{board}</code></p>
  2949. <p><em>Get the board with that particular ID</em></p>
  2950. <h3 id="get_board-parameters">Parameters</h3>
  2951. <table>
  2952. <thead>
  2953. <tr>
  2954. <th>Name</th>
  2955. <th>In</th>
  2956. <th>Type</th>
  2957. <th>Required</th>
  2958. <th>Description</th>
  2959. </tr>
  2960. </thead>
  2961. <tbody>
  2962. <tr>
  2963. <td>board</td>
  2964. <td>path</td>
  2965. <td>string</td>
  2966. <td>true</td>
  2967. <td>the ID of the board to retrieve the data</td>
  2968. </tr>
  2969. </tbody>
  2970. </table>
  2971. <h4 id="detailed-descriptions-2">Detailed descriptions</h4>
  2972. <p><strong>board</strong>: the ID of the board to retrieve the data</p>
  2973. <blockquote>
  2974. <p>Example responses</p>
  2975. </blockquote>
  2976. <blockquote>
  2977. <p>200 Response</p>
  2978. </blockquote>
  2979. <pre class="highlight tab tab-json"><code>{
  2980. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  2981. <span class="hljs-attr">&quot;slug&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  2982. <span class="hljs-attr">&quot;archived&quot;</span>: <span class="hljs-literal">true</span>,
  2983. <span class="hljs-attr">&quot;archivedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  2984. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  2985. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  2986. <span class="hljs-attr">&quot;stars&quot;</span>: <span class="hljs-number">0</span>,
  2987. <span class="hljs-attr">&quot;labels&quot;</span>: [
  2988. {
  2989. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  2990. <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  2991. <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;white&quot;</span>
  2992. }
  2993. ],
  2994. <span class="hljs-attr">&quot;members&quot;</span>: [
  2995. {
  2996. <span class="hljs-attr">&quot;userId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  2997. <span class="hljs-attr">&quot;isAdmin&quot;</span>: <span class="hljs-literal">true</span>,
  2998. <span class="hljs-attr">&quot;isActive&quot;</span>: <span class="hljs-literal">true</span>,
  2999. <span class="hljs-attr">&quot;isNoComments&quot;</span>: <span class="hljs-literal">true</span>,
  3000. <span class="hljs-attr">&quot;isCommentOnly&quot;</span>: <span class="hljs-literal">true</span>,
  3001. <span class="hljs-attr">&quot;isWorker&quot;</span>: <span class="hljs-literal">true</span>
  3002. }
  3003. ],
  3004. <span class="hljs-attr">&quot;permission&quot;</span>: <span class="hljs-string">&quot;public&quot;</span>,
  3005. <span class="hljs-attr">&quot;orgs&quot;</span>: [
  3006. {
  3007. <span class="hljs-attr">&quot;orgId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3008. <span class="hljs-attr">&quot;orgDisplayName&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3009. <span class="hljs-attr">&quot;isActive&quot;</span>: <span class="hljs-literal">true</span>
  3010. }
  3011. ],
  3012. <span class="hljs-attr">&quot;teams&quot;</span>: [
  3013. {
  3014. <span class="hljs-attr">&quot;teamId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3015. <span class="hljs-attr">&quot;teamDisplayName&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3016. <span class="hljs-attr">&quot;isActive&quot;</span>: <span class="hljs-literal">true</span>
  3017. }
  3018. ],
  3019. <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;belize&quot;</span>,
  3020. <span class="hljs-attr">&quot;backgroundImageURL&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3021. <span class="hljs-attr">&quot;allowsCardCounterList&quot;</span>: <span class="hljs-literal">true</span>,
  3022. <span class="hljs-attr">&quot;allowsBoardMemberList&quot;</span>: <span class="hljs-literal">true</span>,
  3023. <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3024. <span class="hljs-attr">&quot;subtasksDefaultBoardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3025. <span class="hljs-attr">&quot;subtasksDefaultListId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3026. <span class="hljs-attr">&quot;dateSettingsDefaultBoardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3027. <span class="hljs-attr">&quot;dateSettingsDefaultListId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3028. <span class="hljs-attr">&quot;allowsSubtasks&quot;</span>: <span class="hljs-literal">true</span>,
  3029. <span class="hljs-attr">&quot;allowsAttachments&quot;</span>: <span class="hljs-literal">true</span>,
  3030. <span class="hljs-attr">&quot;allowsChecklists&quot;</span>: <span class="hljs-literal">true</span>,
  3031. <span class="hljs-attr">&quot;allowsComments&quot;</span>: <span class="hljs-literal">true</span>,
  3032. <span class="hljs-attr">&quot;allowsDescriptionTitle&quot;</span>: <span class="hljs-literal">true</span>,
  3033. <span class="hljs-attr">&quot;allowsDescriptionText&quot;</span>: <span class="hljs-literal">true</span>,
  3034. <span class="hljs-attr">&quot;allowsDescriptionTextOnMinicard&quot;</span>: <span class="hljs-literal">true</span>,
  3035. <span class="hljs-attr">&quot;allowsCoverAttachmentOnMinicard&quot;</span>: <span class="hljs-literal">true</span>,
  3036. <span class="hljs-attr">&quot;allowsBadgeAttachmentOnMinicard&quot;</span>: <span class="hljs-literal">true</span>,
  3037. <span class="hljs-attr">&quot;allowsCardSortingByNumberOnMinicard&quot;</span>: <span class="hljs-literal">true</span>,
  3038. <span class="hljs-attr">&quot;allowsCardNumber&quot;</span>: <span class="hljs-literal">true</span>,
  3039. <span class="hljs-attr">&quot;allowsActivities&quot;</span>: <span class="hljs-literal">true</span>,
  3040. <span class="hljs-attr">&quot;allowsLabels&quot;</span>: <span class="hljs-literal">true</span>,
  3041. <span class="hljs-attr">&quot;allowsCreator&quot;</span>: <span class="hljs-literal">true</span>,
  3042. <span class="hljs-attr">&quot;allowsAssignee&quot;</span>: <span class="hljs-literal">true</span>,
  3043. <span class="hljs-attr">&quot;allowsMembers&quot;</span>: <span class="hljs-literal">true</span>,
  3044. <span class="hljs-attr">&quot;allowsRequestedBy&quot;</span>: <span class="hljs-literal">true</span>,
  3045. <span class="hljs-attr">&quot;allowsCardSortingByNumber&quot;</span>: <span class="hljs-literal">true</span>,
  3046. <span class="hljs-attr">&quot;allowsShowLists&quot;</span>: <span class="hljs-literal">true</span>,
  3047. <span class="hljs-attr">&quot;allowsAssignedBy&quot;</span>: <span class="hljs-literal">true</span>,
  3048. <span class="hljs-attr">&quot;allowsReceivedDate&quot;</span>: <span class="hljs-literal">true</span>,
  3049. <span class="hljs-attr">&quot;allowsStartDate&quot;</span>: <span class="hljs-literal">true</span>,
  3050. <span class="hljs-attr">&quot;allowsEndDate&quot;</span>: <span class="hljs-literal">true</span>,
  3051. <span class="hljs-attr">&quot;allowsDueDate&quot;</span>: <span class="hljs-literal">true</span>,
  3052. <span class="hljs-attr">&quot;presentParentTask&quot;</span>: <span class="hljs-string">&quot;prefix-with-full-path&quot;</span>,
  3053. <span class="hljs-attr">&quot;receivedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3054. <span class="hljs-attr">&quot;startAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3055. <span class="hljs-attr">&quot;dueAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3056. <span class="hljs-attr">&quot;endAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3057. <span class="hljs-attr">&quot;spentTime&quot;</span>: <span class="hljs-number">0</span>,
  3058. <span class="hljs-attr">&quot;isOvertime&quot;</span>: <span class="hljs-literal">true</span>,
  3059. <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;board&quot;</span>,
  3060. <span class="hljs-attr">&quot;sort&quot;</span>: <span class="hljs-number">0</span>
  3061. }
  3062. </code></pre>
  3063. <h3 id="get_board-responses">Responses</h3>
  3064. <table>
  3065. <thead>
  3066. <tr>
  3067. <th>Status</th>
  3068. <th>Meaning</th>
  3069. <th>Description</th>
  3070. <th>Schema</th>
  3071. </tr>
  3072. </thead>
  3073. <tbody>
  3074. <tr>
  3075. <td>200</td>
  3076. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  3077. <td>200 response</td>
  3078. <td><a href="#schemaboards">Boards</a></td>
  3079. </tr>
  3080. </tbody>
  3081. </table>
  3082. <aside class="warning">
  3083. To perform this operation, you must be authenticated by means of one of the following methods:
  3084. UserSecurity
  3085. </aside>
  3086. <h2 id="delete_board">delete_board</h2>
  3087. <p><a id="opIddelete_board"></a></p>
  3088. <blockquote>
  3089. <p>Code samples</p>
  3090. </blockquote>
  3091. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  3092. curl -X DELETE /api/boards/{board} \
  3093. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  3094. </code></pre>
  3095. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">DELETE</span> <span class="hljs-string">/api/boards/{board}</span> <span class="hljs-meta">HTTP/1.1</span>
  3096. </code></pre>
  3097. <pre class="highlight tab tab-javascript"><code>
  3098. <span class="hljs-keyword">const</span> headers = {
  3099. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3100. };
  3101. fetch(<span class="hljs-string">&#x27;/api/boards/{board}&#x27;</span>,
  3102. {
  3103. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  3104. <span class="hljs-attr">headers</span>: headers
  3105. })
  3106. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  3107. <span class="hljs-keyword">return</span> res.json();
  3108. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  3109. <span class="hljs-built_in">console</span>.log(body);
  3110. });
  3111. </code></pre>
  3112. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  3113. <span class="hljs-keyword">const</span> headers = {
  3114. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3115. };
  3116. fetch(<span class="hljs-string">&#x27;/api/boards/{board}&#x27;</span>,
  3117. {
  3118. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  3119. <span class="hljs-attr">headers</span>: headers
  3120. })
  3121. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  3122. <span class="hljs-keyword">return</span> res.json();
  3123. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  3124. <span class="hljs-built_in">console</span>.log(body);
  3125. });
  3126. </code></pre>
  3127. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  3128. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  3129. headers = {
  3130. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3131. }
  3132. result = RestClient.delete <span class="hljs-string">&#x27;/api/boards/{board}&#x27;</span>,
  3133. <span class="hljs-symbol">params:</span> {
  3134. }, <span class="hljs-symbol">headers:</span> headers
  3135. p JSON.parse(result)
  3136. </code></pre>
  3137. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  3138. headers = {
  3139. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3140. }
  3141. r = requests.delete(<span class="hljs-string">&#x27;/api/boards/{board}&#x27;</span>, headers = headers)
  3142. <span class="hljs-built_in">print</span>(r.json())
  3143. </code></pre>
  3144. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}&quot;</span>);
  3145. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  3146. con.setRequestMethod(<span class="hljs-string">&quot;DELETE&quot;</span>);
  3147. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  3148. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  3149. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  3150. String inputLine;
  3151. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  3152. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  3153. response.append(inputLine);
  3154. }
  3155. in.close();
  3156. System.out.println(response.toString());
  3157. </code></pre>
  3158. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  3159. <span class="hljs-keyword">import</span> (
  3160. <span class="hljs-string">&quot;bytes&quot;</span>
  3161. <span class="hljs-string">&quot;net/http&quot;</span>
  3162. )
  3163. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  3164. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  3165. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  3166. }
  3167. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  3168. req, err := http.NewRequest(<span class="hljs-string">&quot;DELETE&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}&quot;</span>, data)
  3169. req.Header = headers
  3170. client := &amp;http.Client{}
  3171. resp, err := client.Do(req)
  3172. <span class="hljs-comment">// ...</span>
  3173. }
  3174. </code></pre>
  3175. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  3176. );
  3177. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  3178. <span class="hljs-comment">// Define array of request body.</span>
  3179. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  3180. <span class="hljs-keyword">try</span> {
  3181. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;DELETE&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}&#x27;</span>, <span class="hljs-keyword">array</span>(
  3182. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  3183. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  3184. )
  3185. );
  3186. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  3187. }
  3188. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  3189. <span class="hljs-comment">// handle exception or api errors.</span>
  3190. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  3191. }
  3192. <span class="hljs-comment">// ...</span>
  3193. </code></pre>
  3194. <p><code>DELETE /api/boards/{board}</code></p>
  3195. <p><em>Delete a board</em></p>
  3196. <h3 id="delete_board-parameters">Parameters</h3>
  3197. <table>
  3198. <thead>
  3199. <tr>
  3200. <th>Name</th>
  3201. <th>In</th>
  3202. <th>Type</th>
  3203. <th>Required</th>
  3204. <th>Description</th>
  3205. </tr>
  3206. </thead>
  3207. <tbody>
  3208. <tr>
  3209. <td>board</td>
  3210. <td>path</td>
  3211. <td>string</td>
  3212. <td>true</td>
  3213. <td>the ID of the board</td>
  3214. </tr>
  3215. </tbody>
  3216. </table>
  3217. <h4 id="detailed-descriptions-3">Detailed descriptions</h4>
  3218. <p><strong>board</strong>: the ID of the board</p>
  3219. <h3 id="delete_board-responses">Responses</h3>
  3220. <table>
  3221. <thead>
  3222. <tr>
  3223. <th>Status</th>
  3224. <th>Meaning</th>
  3225. <th>Description</th>
  3226. <th>Schema</th>
  3227. </tr>
  3228. </thead>
  3229. <tbody>
  3230. <tr>
  3231. <td>200</td>
  3232. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  3233. <td>200 response</td>
  3234. <td>None</td>
  3235. </tr>
  3236. </tbody>
  3237. </table>
  3238. <aside class="warning">
  3239. To perform this operation, you must be authenticated by means of one of the following methods:
  3240. UserSecurity
  3241. </aside>
  3242. <h2 id="get_board_attachments">get_board_attachments</h2>
  3243. <p><a id="opIdget_board_attachments"></a></p>
  3244. <blockquote>
  3245. <p>Code samples</p>
  3246. </blockquote>
  3247. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  3248. curl -X GET /api/boards/{board}/attachments \
  3249. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  3250. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  3251. </code></pre>
  3252. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/attachments</span> <span class="hljs-meta">HTTP/1.1</span>
  3253. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  3254. </span></code></pre>
  3255. <pre class="highlight tab tab-javascript"><code>
  3256. <span class="hljs-keyword">const</span> headers = {
  3257. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  3258. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3259. };
  3260. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/attachments&#x27;</span>,
  3261. {
  3262. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  3263. <span class="hljs-attr">headers</span>: headers
  3264. })
  3265. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  3266. <span class="hljs-keyword">return</span> res.json();
  3267. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  3268. <span class="hljs-built_in">console</span>.log(body);
  3269. });
  3270. </code></pre>
  3271. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  3272. <span class="hljs-keyword">const</span> headers = {
  3273. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  3274. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3275. };
  3276. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/attachments&#x27;</span>,
  3277. {
  3278. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  3279. <span class="hljs-attr">headers</span>: headers
  3280. })
  3281. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  3282. <span class="hljs-keyword">return</span> res.json();
  3283. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  3284. <span class="hljs-built_in">console</span>.log(body);
  3285. });
  3286. </code></pre>
  3287. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  3288. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  3289. headers = {
  3290. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  3291. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3292. }
  3293. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/attachments&#x27;</span>,
  3294. <span class="hljs-symbol">params:</span> {
  3295. }, <span class="hljs-symbol">headers:</span> headers
  3296. p JSON.parse(result)
  3297. </code></pre>
  3298. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  3299. headers = {
  3300. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  3301. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3302. }
  3303. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/attachments&#x27;</span>, headers = headers)
  3304. <span class="hljs-built_in">print</span>(r.json())
  3305. </code></pre>
  3306. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/attachments&quot;</span>);
  3307. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  3308. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  3309. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  3310. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  3311. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  3312. String inputLine;
  3313. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  3314. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  3315. response.append(inputLine);
  3316. }
  3317. in.close();
  3318. System.out.println(response.toString());
  3319. </code></pre>
  3320. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  3321. <span class="hljs-keyword">import</span> (
  3322. <span class="hljs-string">&quot;bytes&quot;</span>
  3323. <span class="hljs-string">&quot;net/http&quot;</span>
  3324. )
  3325. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  3326. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  3327. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  3328. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  3329. }
  3330. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  3331. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/attachments&quot;</span>, data)
  3332. req.Header = headers
  3333. client := &amp;http.Client{}
  3334. resp, err := client.Do(req)
  3335. <span class="hljs-comment">// ...</span>
  3336. }
  3337. </code></pre>
  3338. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  3339. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  3340. );
  3341. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  3342. <span class="hljs-comment">// Define array of request body.</span>
  3343. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  3344. <span class="hljs-keyword">try</span> {
  3345. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/attachments&#x27;</span>, <span class="hljs-keyword">array</span>(
  3346. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  3347. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  3348. )
  3349. );
  3350. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  3351. }
  3352. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  3353. <span class="hljs-comment">// handle exception or api errors.</span>
  3354. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  3355. }
  3356. <span class="hljs-comment">// ...</span>
  3357. </code></pre>
  3358. <p><code>GET /api/boards/{board}/attachments</code></p>
  3359. <p><em>Get the list of attachments of a board</em></p>
  3360. <h3 id="get_board_attachments-parameters">Parameters</h3>
  3361. <table>
  3362. <thead>
  3363. <tr>
  3364. <th>Name</th>
  3365. <th>In</th>
  3366. <th>Type</th>
  3367. <th>Required</th>
  3368. <th>Description</th>
  3369. </tr>
  3370. </thead>
  3371. <tbody>
  3372. <tr>
  3373. <td>board</td>
  3374. <td>path</td>
  3375. <td>string</td>
  3376. <td>true</td>
  3377. <td>the board ID</td>
  3378. </tr>
  3379. </tbody>
  3380. </table>
  3381. <h4 id="detailed-descriptions-4">Detailed descriptions</h4>
  3382. <p><strong>board</strong>: the board ID</p>
  3383. <blockquote>
  3384. <p>Example responses</p>
  3385. </blockquote>
  3386. <blockquote>
  3387. <p>200 Response</p>
  3388. </blockquote>
  3389. <pre class="highlight tab tab-json"><code>[
  3390. {
  3391. <span class="hljs-attr">&quot;attachmentId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3392. <span class="hljs-attr">&quot;attachmentName&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3393. <span class="hljs-attr">&quot;attachmentType&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3394. <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3395. <span class="hljs-attr">&quot;urlDownload&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3396. <span class="hljs-attr">&quot;boardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3397. <span class="hljs-attr">&quot;swimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3398. <span class="hljs-attr">&quot;listId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  3399. <span class="hljs-attr">&quot;cardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  3400. }
  3401. ]
  3402. </code></pre>
  3403. <h3 id="get_board_attachments-responses">Responses</h3>
  3404. <table>
  3405. <thead>
  3406. <tr>
  3407. <th>Status</th>
  3408. <th>Meaning</th>
  3409. <th>Description</th>
  3410. <th>Schema</th>
  3411. </tr>
  3412. </thead>
  3413. <tbody>
  3414. <tr>
  3415. <td>200</td>
  3416. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  3417. <td>200 response</td>
  3418. <td>Inline</td>
  3419. </tr>
  3420. </tbody>
  3421. </table>
  3422. <h3 id="get_board_attachments-responseschema">Response Schema</h3>
  3423. <p>Status Code <strong>200</strong></p>
  3424. <table>
  3425. <thead>
  3426. <tr>
  3427. <th>Name</th>
  3428. <th>Type</th>
  3429. <th>Required</th>
  3430. <th>Restrictions</th>
  3431. <th>Description</th>
  3432. </tr>
  3433. </thead>
  3434. <tbody>
  3435. <tr>
  3436. <td>» attachmentId</td>
  3437. <td>string</td>
  3438. <td>false</td>
  3439. <td>none</td>
  3440. <td>none</td>
  3441. </tr>
  3442. <tr>
  3443. <td>» attachmentName</td>
  3444. <td>string</td>
  3445. <td>false</td>
  3446. <td>none</td>
  3447. <td>none</td>
  3448. </tr>
  3449. <tr>
  3450. <td>» attachmentType</td>
  3451. <td>string</td>
  3452. <td>false</td>
  3453. <td>none</td>
  3454. <td>none</td>
  3455. </tr>
  3456. <tr>
  3457. <td>» url</td>
  3458. <td>string</td>
  3459. <td>false</td>
  3460. <td>none</td>
  3461. <td>none</td>
  3462. </tr>
  3463. <tr>
  3464. <td>» urlDownload</td>
  3465. <td>string</td>
  3466. <td>false</td>
  3467. <td>none</td>
  3468. <td>none</td>
  3469. </tr>
  3470. <tr>
  3471. <td>» boardId</td>
  3472. <td>string</td>
  3473. <td>false</td>
  3474. <td>none</td>
  3475. <td>none</td>
  3476. </tr>
  3477. <tr>
  3478. <td>» swimlaneId</td>
  3479. <td>string</td>
  3480. <td>false</td>
  3481. <td>none</td>
  3482. <td>none</td>
  3483. </tr>
  3484. <tr>
  3485. <td>» listId</td>
  3486. <td>string</td>
  3487. <td>false</td>
  3488. <td>none</td>
  3489. <td>none</td>
  3490. </tr>
  3491. <tr>
  3492. <td>» cardId</td>
  3493. <td>string</td>
  3494. <td>false</td>
  3495. <td>none</td>
  3496. <td>none</td>
  3497. </tr>
  3498. </tbody>
  3499. </table>
  3500. <aside class="warning">
  3501. To perform this operation, you must be authenticated by means of one of the following methods:
  3502. UserSecurity
  3503. </aside>
  3504. <h2 id="exportjson">exportJson</h2>
  3505. <p><a id="opIdexportJson"></a></p>
  3506. <blockquote>
  3507. <p>Code samples</p>
  3508. </blockquote>
  3509. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  3510. curl -X GET /api/boards/{board}/<span class="hljs-built_in">export</span> \
  3511. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  3512. </code></pre>
  3513. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/export</span> <span class="hljs-meta">HTTP/1.1</span>
  3514. </code></pre>
  3515. <pre class="highlight tab tab-javascript"><code>
  3516. <span class="hljs-keyword">const</span> headers = {
  3517. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3518. };
  3519. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/export&#x27;</span>,
  3520. {
  3521. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  3522. <span class="hljs-attr">headers</span>: headers
  3523. })
  3524. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  3525. <span class="hljs-keyword">return</span> res.json();
  3526. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  3527. <span class="hljs-built_in">console</span>.log(body);
  3528. });
  3529. </code></pre>
  3530. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  3531. <span class="hljs-keyword">const</span> headers = {
  3532. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3533. };
  3534. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/export&#x27;</span>,
  3535. {
  3536. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  3537. <span class="hljs-attr">headers</span>: headers
  3538. })
  3539. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  3540. <span class="hljs-keyword">return</span> res.json();
  3541. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  3542. <span class="hljs-built_in">console</span>.log(body);
  3543. });
  3544. </code></pre>
  3545. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  3546. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  3547. headers = {
  3548. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3549. }
  3550. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/export&#x27;</span>,
  3551. <span class="hljs-symbol">params:</span> {
  3552. }, <span class="hljs-symbol">headers:</span> headers
  3553. p JSON.parse(result)
  3554. </code></pre>
  3555. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  3556. headers = {
  3557. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3558. }
  3559. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/export&#x27;</span>, headers = headers)
  3560. <span class="hljs-built_in">print</span>(r.json())
  3561. </code></pre>
  3562. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/export&quot;</span>);
  3563. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  3564. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  3565. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  3566. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  3567. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  3568. String inputLine;
  3569. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  3570. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  3571. response.append(inputLine);
  3572. }
  3573. in.close();
  3574. System.out.println(response.toString());
  3575. </code></pre>
  3576. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  3577. <span class="hljs-keyword">import</span> (
  3578. <span class="hljs-string">&quot;bytes&quot;</span>
  3579. <span class="hljs-string">&quot;net/http&quot;</span>
  3580. )
  3581. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  3582. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  3583. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  3584. }
  3585. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  3586. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/export&quot;</span>, data)
  3587. req.Header = headers
  3588. client := &amp;http.Client{}
  3589. resp, err := client.Do(req)
  3590. <span class="hljs-comment">// ...</span>
  3591. }
  3592. </code></pre>
  3593. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  3594. );
  3595. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  3596. <span class="hljs-comment">// Define array of request body.</span>
  3597. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  3598. <span class="hljs-keyword">try</span> {
  3599. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/export&#x27;</span>, <span class="hljs-keyword">array</span>(
  3600. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  3601. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  3602. )
  3603. );
  3604. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  3605. }
  3606. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  3607. <span class="hljs-comment">// handle exception or api errors.</span>
  3608. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  3609. }
  3610. <span class="hljs-comment">// ...</span>
  3611. </code></pre>
  3612. <p><code>GET /api/boards/{board}/export</code></p>
  3613. <p><em>This route is used to export the board to a json file format.</em></p>
  3614. <p>If user is already logged-in, pass loginToken as param
  3615. &quot;authToken&quot;: '/api/boards/:boardId/export?authToken=:token'</p>
  3616. <p>See <a href="https://blog.kayla.com.au/server-side-route-authentication-in-meteor/">https://blog.kayla.com.au/server-side-route-authentication-in-meteor/</a>
  3617. for detailed explanations</p>
  3618. <h3 id="exportjson-parameters">Parameters</h3>
  3619. <table>
  3620. <thead>
  3621. <tr>
  3622. <th>Name</th>
  3623. <th>In</th>
  3624. <th>Type</th>
  3625. <th>Required</th>
  3626. <th>Description</th>
  3627. </tr>
  3628. </thead>
  3629. <tbody>
  3630. <tr>
  3631. <td>board</td>
  3632. <td>path</td>
  3633. <td>string</td>
  3634. <td>true</td>
  3635. <td>the ID of the board we are exporting</td>
  3636. </tr>
  3637. </tbody>
  3638. </table>
  3639. <h4 id="detailed-descriptions-5">Detailed descriptions</h4>
  3640. <p><strong>board</strong>: the ID of the board we are exporting</p>
  3641. <h3 id="exportjson-responses">Responses</h3>
  3642. <table>
  3643. <thead>
  3644. <tr>
  3645. <th>Status</th>
  3646. <th>Meaning</th>
  3647. <th>Description</th>
  3648. <th>Schema</th>
  3649. </tr>
  3650. </thead>
  3651. <tbody>
  3652. <tr>
  3653. <td>200</td>
  3654. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  3655. <td>200 response</td>
  3656. <td>None</td>
  3657. </tr>
  3658. </tbody>
  3659. </table>
  3660. <aside class="warning">
  3661. To perform this operation, you must be authenticated by means of one of the following methods:
  3662. UserSecurity
  3663. </aside>
  3664. <h2 id="add_board_label">add_board_label</h2>
  3665. <p><a id="opIdadd_board_label"></a></p>
  3666. <blockquote>
  3667. <p>Code samples</p>
  3668. </blockquote>
  3669. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  3670. curl -X PUT /api/boards/{board}/labels \
  3671. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  3672. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  3673. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  3674. </code></pre>
  3675. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">PUT</span> <span class="hljs-string">/api/boards/{board}/labels</span> <span class="hljs-meta">HTTP/1.1</span>
  3676. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  3677. Accept: application/json
  3678. </span></code></pre>
  3679. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  3680. &quot;label&quot;: &quot;string&quot;
  3681. }&#x27;</span>;
  3682. <span class="hljs-keyword">const</span> headers = {
  3683. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  3684. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  3685. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3686. };
  3687. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/labels&#x27;</span>,
  3688. {
  3689. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;PUT&#x27;</span>,
  3690. <span class="hljs-attr">body</span>: inputBody,
  3691. <span class="hljs-attr">headers</span>: headers
  3692. })
  3693. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  3694. <span class="hljs-keyword">return</span> res.json();
  3695. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  3696. <span class="hljs-built_in">console</span>.log(body);
  3697. });
  3698. </code></pre>
  3699. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  3700. <span class="hljs-keyword">const</span> inputBody = {
  3701. <span class="hljs-string">&quot;label&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  3702. };
  3703. <span class="hljs-keyword">const</span> headers = {
  3704. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  3705. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  3706. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3707. };
  3708. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/labels&#x27;</span>,
  3709. {
  3710. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;PUT&#x27;</span>,
  3711. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  3712. <span class="hljs-attr">headers</span>: headers
  3713. })
  3714. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  3715. <span class="hljs-keyword">return</span> res.json();
  3716. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  3717. <span class="hljs-built_in">console</span>.log(body);
  3718. });
  3719. </code></pre>
  3720. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  3721. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  3722. headers = {
  3723. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  3724. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  3725. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3726. }
  3727. result = RestClient.put <span class="hljs-string">&#x27;/api/boards/{board}/labels&#x27;</span>,
  3728. <span class="hljs-symbol">params:</span> {
  3729. }, <span class="hljs-symbol">headers:</span> headers
  3730. p JSON.parse(result)
  3731. </code></pre>
  3732. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  3733. headers = {
  3734. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  3735. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  3736. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3737. }
  3738. r = requests.put(<span class="hljs-string">&#x27;/api/boards/{board}/labels&#x27;</span>, headers = headers)
  3739. <span class="hljs-built_in">print</span>(r.json())
  3740. </code></pre>
  3741. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/labels&quot;</span>);
  3742. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  3743. con.setRequestMethod(<span class="hljs-string">&quot;PUT&quot;</span>);
  3744. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  3745. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  3746. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  3747. String inputLine;
  3748. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  3749. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  3750. response.append(inputLine);
  3751. }
  3752. in.close();
  3753. System.out.println(response.toString());
  3754. </code></pre>
  3755. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  3756. <span class="hljs-keyword">import</span> (
  3757. <span class="hljs-string">&quot;bytes&quot;</span>
  3758. <span class="hljs-string">&quot;net/http&quot;</span>
  3759. )
  3760. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  3761. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  3762. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  3763. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  3764. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  3765. }
  3766. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  3767. req, err := http.NewRequest(<span class="hljs-string">&quot;PUT&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/labels&quot;</span>, data)
  3768. req.Header = headers
  3769. client := &amp;http.Client{}
  3770. resp, err := client.Do(req)
  3771. <span class="hljs-comment">// ...</span>
  3772. }
  3773. </code></pre>
  3774. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  3775. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  3776. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  3777. );
  3778. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  3779. <span class="hljs-comment">// Define array of request body.</span>
  3780. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  3781. <span class="hljs-keyword">try</span> {
  3782. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;PUT&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/labels&#x27;</span>, <span class="hljs-keyword">array</span>(
  3783. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  3784. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  3785. )
  3786. );
  3787. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  3788. }
  3789. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  3790. <span class="hljs-comment">// handle exception or api errors.</span>
  3791. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  3792. }
  3793. <span class="hljs-comment">// ...</span>
  3794. </code></pre>
  3795. <p><code>PUT /api/boards/{board}/labels</code></p>
  3796. <p><em>Add a label to a board</em></p>
  3797. <p>If the board doesn't have the name/color label, this function
  3798. adds the label to the board.</p>
  3799. <blockquote>
  3800. <p>Body parameter</p>
  3801. </blockquote>
  3802. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">label:</span> <span class="hljs-string">string</span>
  3803. </code></pre>
  3804. <h3 id="add_board_label-parameters">Parameters</h3>
  3805. <table>
  3806. <thead>
  3807. <tr>
  3808. <th>Name</th>
  3809. <th>In</th>
  3810. <th>Type</th>
  3811. <th>Required</th>
  3812. <th>Description</th>
  3813. </tr>
  3814. </thead>
  3815. <tbody>
  3816. <tr>
  3817. <td>board</td>
  3818. <td>path</td>
  3819. <td>string</td>
  3820. <td>true</td>
  3821. <td>the board</td>
  3822. </tr>
  3823. <tr>
  3824. <td>body</td>
  3825. <td>body</td>
  3826. <td>object</td>
  3827. <td>true</td>
  3828. <td>none</td>
  3829. </tr>
  3830. <tr>
  3831. <td>» label</td>
  3832. <td>body</td>
  3833. <td>string</td>
  3834. <td>true</td>
  3835. <td>the label value</td>
  3836. </tr>
  3837. </tbody>
  3838. </table>
  3839. <h4 id="detailed-descriptions-6">Detailed descriptions</h4>
  3840. <p><strong>board</strong>: the board</p>
  3841. <blockquote>
  3842. <p>Example responses</p>
  3843. </blockquote>
  3844. <blockquote>
  3845. <p>200 Response</p>
  3846. </blockquote>
  3847. <pre class="highlight tab tab-json"><code><span class="hljs-string">&quot;string&quot;</span>
  3848. </code></pre>
  3849. <h3 id="add_board_label-responses">Responses</h3>
  3850. <table>
  3851. <thead>
  3852. <tr>
  3853. <th>Status</th>
  3854. <th>Meaning</th>
  3855. <th>Description</th>
  3856. <th>Schema</th>
  3857. </tr>
  3858. </thead>
  3859. <tbody>
  3860. <tr>
  3861. <td>200</td>
  3862. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  3863. <td>200 response</td>
  3864. <td>string</td>
  3865. </tr>
  3866. </tbody>
  3867. </table>
  3868. <aside class="warning">
  3869. To perform this operation, you must be authenticated by means of one of the following methods:
  3870. UserSecurity
  3871. </aside>
  3872. <h2 id="set_board_member_permission">set_board_member_permission</h2>
  3873. <p><a id="opIdset_board_member_permission"></a></p>
  3874. <blockquote>
  3875. <p>Code samples</p>
  3876. </blockquote>
  3877. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  3878. curl -X POST /api/boards/{board}/members/{member} \
  3879. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  3880. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  3881. </code></pre>
  3882. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/boards/{board}/members/{member}</span> <span class="hljs-meta">HTTP/1.1</span>
  3883. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  3884. </span></code></pre>
  3885. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  3886. &quot;isAdmin&quot;: true,
  3887. &quot;isNoComments&quot;: true,
  3888. &quot;isCommentOnly&quot;: true,
  3889. &quot;isWorker&quot;: true
  3890. }&#x27;</span>;
  3891. <span class="hljs-keyword">const</span> headers = {
  3892. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  3893. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3894. };
  3895. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/members/{member}&#x27;</span>,
  3896. {
  3897. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  3898. <span class="hljs-attr">body</span>: inputBody,
  3899. <span class="hljs-attr">headers</span>: headers
  3900. })
  3901. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  3902. <span class="hljs-keyword">return</span> res.json();
  3903. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  3904. <span class="hljs-built_in">console</span>.log(body);
  3905. });
  3906. </code></pre>
  3907. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  3908. <span class="hljs-keyword">const</span> inputBody = {
  3909. <span class="hljs-string">&quot;isAdmin&quot;</span>: <span class="hljs-literal">true</span>,
  3910. <span class="hljs-string">&quot;isNoComments&quot;</span>: <span class="hljs-literal">true</span>,
  3911. <span class="hljs-string">&quot;isCommentOnly&quot;</span>: <span class="hljs-literal">true</span>,
  3912. <span class="hljs-string">&quot;isWorker&quot;</span>: <span class="hljs-literal">true</span>
  3913. };
  3914. <span class="hljs-keyword">const</span> headers = {
  3915. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  3916. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3917. };
  3918. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/members/{member}&#x27;</span>,
  3919. {
  3920. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  3921. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  3922. <span class="hljs-attr">headers</span>: headers
  3923. })
  3924. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  3925. <span class="hljs-keyword">return</span> res.json();
  3926. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  3927. <span class="hljs-built_in">console</span>.log(body);
  3928. });
  3929. </code></pre>
  3930. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  3931. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  3932. headers = {
  3933. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  3934. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3935. }
  3936. result = RestClient.post <span class="hljs-string">&#x27;/api/boards/{board}/members/{member}&#x27;</span>,
  3937. <span class="hljs-symbol">params:</span> {
  3938. }, <span class="hljs-symbol">headers:</span> headers
  3939. p JSON.parse(result)
  3940. </code></pre>
  3941. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  3942. headers = {
  3943. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  3944. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  3945. }
  3946. r = requests.post(<span class="hljs-string">&#x27;/api/boards/{board}/members/{member}&#x27;</span>, headers = headers)
  3947. <span class="hljs-built_in">print</span>(r.json())
  3948. </code></pre>
  3949. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/members/{member}&quot;</span>);
  3950. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  3951. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  3952. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  3953. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  3954. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  3955. String inputLine;
  3956. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  3957. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  3958. response.append(inputLine);
  3959. }
  3960. in.close();
  3961. System.out.println(response.toString());
  3962. </code></pre>
  3963. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  3964. <span class="hljs-keyword">import</span> (
  3965. <span class="hljs-string">&quot;bytes&quot;</span>
  3966. <span class="hljs-string">&quot;net/http&quot;</span>
  3967. )
  3968. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  3969. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  3970. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  3971. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  3972. }
  3973. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  3974. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/members/{member}&quot;</span>, data)
  3975. req.Header = headers
  3976. client := &amp;http.Client{}
  3977. resp, err := client.Do(req)
  3978. <span class="hljs-comment">// ...</span>
  3979. }
  3980. </code></pre>
  3981. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  3982. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  3983. );
  3984. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  3985. <span class="hljs-comment">// Define array of request body.</span>
  3986. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  3987. <span class="hljs-keyword">try</span> {
  3988. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/members/{member}&#x27;</span>, <span class="hljs-keyword">array</span>(
  3989. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  3990. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  3991. )
  3992. );
  3993. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  3994. }
  3995. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  3996. <span class="hljs-comment">// handle exception or api errors.</span>
  3997. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  3998. }
  3999. <span class="hljs-comment">// ...</span>
  4000. </code></pre>
  4001. <p><code>POST /api/boards/{board}/members/{member}</code></p>
  4002. <p><em>Change the permission of a member of a board</em></p>
  4003. <blockquote>
  4004. <p>Body parameter</p>
  4005. </blockquote>
  4006. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">isAdmin:</span> <span class="hljs-literal">true</span>
  4007. <span class="hljs-attr">isNoComments:</span> <span class="hljs-literal">true</span>
  4008. <span class="hljs-attr">isCommentOnly:</span> <span class="hljs-literal">true</span>
  4009. <span class="hljs-attr">isWorker:</span> <span class="hljs-literal">true</span>
  4010. </code></pre>
  4011. <h3 id="set_board_member_permission-parameters">Parameters</h3>
  4012. <table>
  4013. <thead>
  4014. <tr>
  4015. <th>Name</th>
  4016. <th>In</th>
  4017. <th>Type</th>
  4018. <th>Required</th>
  4019. <th>Description</th>
  4020. </tr>
  4021. </thead>
  4022. <tbody>
  4023. <tr>
  4024. <td>board</td>
  4025. <td>path</td>
  4026. <td>string</td>
  4027. <td>true</td>
  4028. <td>the ID of the board that we are changing</td>
  4029. </tr>
  4030. <tr>
  4031. <td>member</td>
  4032. <td>path</td>
  4033. <td>string</td>
  4034. <td>true</td>
  4035. <td>the ID of the user to change permissions</td>
  4036. </tr>
  4037. <tr>
  4038. <td>body</td>
  4039. <td>body</td>
  4040. <td>object</td>
  4041. <td>true</td>
  4042. <td>none</td>
  4043. </tr>
  4044. <tr>
  4045. <td>» isAdmin</td>
  4046. <td>body</td>
  4047. <td>boolean</td>
  4048. <td>true</td>
  4049. <td>admin capability</td>
  4050. </tr>
  4051. <tr>
  4052. <td>» isNoComments</td>
  4053. <td>body</td>
  4054. <td>boolean</td>
  4055. <td>true</td>
  4056. <td>NoComments capability</td>
  4057. </tr>
  4058. <tr>
  4059. <td>» isCommentOnly</td>
  4060. <td>body</td>
  4061. <td>boolean</td>
  4062. <td>true</td>
  4063. <td>CommentsOnly capability</td>
  4064. </tr>
  4065. <tr>
  4066. <td>» isWorker</td>
  4067. <td>body</td>
  4068. <td>boolean</td>
  4069. <td>true</td>
  4070. <td>Worker capability</td>
  4071. </tr>
  4072. </tbody>
  4073. </table>
  4074. <h4 id="detailed-descriptions-7">Detailed descriptions</h4>
  4075. <p><strong>board</strong>: the ID of the board that we are changing</p>
  4076. <p><strong>member</strong>: the ID of the user to change permissions</p>
  4077. <h3 id="set_board_member_permission-responses">Responses</h3>
  4078. <table>
  4079. <thead>
  4080. <tr>
  4081. <th>Status</th>
  4082. <th>Meaning</th>
  4083. <th>Description</th>
  4084. <th>Schema</th>
  4085. </tr>
  4086. </thead>
  4087. <tbody>
  4088. <tr>
  4089. <td>200</td>
  4090. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  4091. <td>200 response</td>
  4092. <td>None</td>
  4093. </tr>
  4094. </tbody>
  4095. </table>
  4096. <aside class="warning">
  4097. To perform this operation, you must be authenticated by means of one of the following methods:
  4098. UserSecurity
  4099. </aside>
  4100. <h2 id="get_boards_count">get_boards_count</h2>
  4101. <p><a id="opIdget_boards_count"></a></p>
  4102. <blockquote>
  4103. <p>Code samples</p>
  4104. </blockquote>
  4105. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  4106. curl -X GET /api/boards_count \
  4107. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  4108. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  4109. </code></pre>
  4110. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards_count</span> <span class="hljs-meta">HTTP/1.1</span>
  4111. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  4112. </span></code></pre>
  4113. <pre class="highlight tab tab-javascript"><code>
  4114. <span class="hljs-keyword">const</span> headers = {
  4115. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  4116. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4117. };
  4118. fetch(<span class="hljs-string">&#x27;/api/boards_count&#x27;</span>,
  4119. {
  4120. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  4121. <span class="hljs-attr">headers</span>: headers
  4122. })
  4123. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  4124. <span class="hljs-keyword">return</span> res.json();
  4125. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  4126. <span class="hljs-built_in">console</span>.log(body);
  4127. });
  4128. </code></pre>
  4129. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  4130. <span class="hljs-keyword">const</span> headers = {
  4131. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  4132. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4133. };
  4134. fetch(<span class="hljs-string">&#x27;/api/boards_count&#x27;</span>,
  4135. {
  4136. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  4137. <span class="hljs-attr">headers</span>: headers
  4138. })
  4139. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  4140. <span class="hljs-keyword">return</span> res.json();
  4141. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  4142. <span class="hljs-built_in">console</span>.log(body);
  4143. });
  4144. </code></pre>
  4145. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  4146. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  4147. headers = {
  4148. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  4149. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4150. }
  4151. result = RestClient.get <span class="hljs-string">&#x27;/api/boards_count&#x27;</span>,
  4152. <span class="hljs-symbol">params:</span> {
  4153. }, <span class="hljs-symbol">headers:</span> headers
  4154. p JSON.parse(result)
  4155. </code></pre>
  4156. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  4157. headers = {
  4158. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  4159. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4160. }
  4161. r = requests.get(<span class="hljs-string">&#x27;/api/boards_count&#x27;</span>, headers = headers)
  4162. <span class="hljs-built_in">print</span>(r.json())
  4163. </code></pre>
  4164. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards_count&quot;</span>);
  4165. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  4166. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  4167. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  4168. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  4169. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  4170. String inputLine;
  4171. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  4172. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  4173. response.append(inputLine);
  4174. }
  4175. in.close();
  4176. System.out.println(response.toString());
  4177. </code></pre>
  4178. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  4179. <span class="hljs-keyword">import</span> (
  4180. <span class="hljs-string">&quot;bytes&quot;</span>
  4181. <span class="hljs-string">&quot;net/http&quot;</span>
  4182. )
  4183. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  4184. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  4185. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  4186. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  4187. }
  4188. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  4189. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards_count&quot;</span>, data)
  4190. req.Header = headers
  4191. client := &amp;http.Client{}
  4192. resp, err := client.Do(req)
  4193. <span class="hljs-comment">// ...</span>
  4194. }
  4195. </code></pre>
  4196. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  4197. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  4198. );
  4199. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  4200. <span class="hljs-comment">// Define array of request body.</span>
  4201. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  4202. <span class="hljs-keyword">try</span> {
  4203. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards_count&#x27;</span>, <span class="hljs-keyword">array</span>(
  4204. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  4205. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  4206. )
  4207. );
  4208. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  4209. }
  4210. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  4211. <span class="hljs-comment">// handle exception or api errors.</span>
  4212. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  4213. }
  4214. <span class="hljs-comment">// ...</span>
  4215. </code></pre>
  4216. <p><code>GET /api/boards_count</code></p>
  4217. <p><em>Get public and private boards count</em></p>
  4218. <blockquote>
  4219. <p>Example responses</p>
  4220. </blockquote>
  4221. <blockquote>
  4222. <p>200 Response</p>
  4223. </blockquote>
  4224. <pre class="highlight tab tab-json"><code>{
  4225. <span class="hljs-attr">&quot;private&quot;</span>: <span class="hljs-number">0</span>,
  4226. <span class="hljs-attr">&quot;public&quot;</span>: <span class="hljs-number">0</span>
  4227. }
  4228. </code></pre>
  4229. <h3 id="get_boards_count-responses">Responses</h3>
  4230. <table>
  4231. <thead>
  4232. <tr>
  4233. <th>Status</th>
  4234. <th>Meaning</th>
  4235. <th>Description</th>
  4236. <th>Schema</th>
  4237. </tr>
  4238. </thead>
  4239. <tbody>
  4240. <tr>
  4241. <td>200</td>
  4242. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  4243. <td>200 response</td>
  4244. <td>Inline</td>
  4245. </tr>
  4246. </tbody>
  4247. </table>
  4248. <h3 id="get_boards_count-responseschema">Response Schema</h3>
  4249. <p>Status Code <strong>200</strong></p>
  4250. <table>
  4251. <thead>
  4252. <tr>
  4253. <th>Name</th>
  4254. <th>Type</th>
  4255. <th>Required</th>
  4256. <th>Restrictions</th>
  4257. <th>Description</th>
  4258. </tr>
  4259. </thead>
  4260. <tbody>
  4261. <tr>
  4262. <td>» private</td>
  4263. <td>integer</td>
  4264. <td>false</td>
  4265. <td>none</td>
  4266. <td>none</td>
  4267. </tr>
  4268. <tr>
  4269. <td>» public</td>
  4270. <td>integer</td>
  4271. <td>false</td>
  4272. <td>none</td>
  4273. <td>none</td>
  4274. </tr>
  4275. </tbody>
  4276. </table>
  4277. <aside class="warning">
  4278. To perform this operation, you must be authenticated by means of one of the following methods:
  4279. UserSecurity
  4280. </aside>
  4281. <h2 id="get_boards_from_user">get_boards_from_user</h2>
  4282. <p><a id="opIdget_boards_from_user"></a></p>
  4283. <blockquote>
  4284. <p>Code samples</p>
  4285. </blockquote>
  4286. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  4287. curl -X GET /api/users/{user}/boards \
  4288. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  4289. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  4290. </code></pre>
  4291. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/users/{user}/boards</span> <span class="hljs-meta">HTTP/1.1</span>
  4292. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  4293. </span></code></pre>
  4294. <pre class="highlight tab tab-javascript"><code>
  4295. <span class="hljs-keyword">const</span> headers = {
  4296. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  4297. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4298. };
  4299. fetch(<span class="hljs-string">&#x27;/api/users/{user}/boards&#x27;</span>,
  4300. {
  4301. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  4302. <span class="hljs-attr">headers</span>: headers
  4303. })
  4304. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  4305. <span class="hljs-keyword">return</span> res.json();
  4306. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  4307. <span class="hljs-built_in">console</span>.log(body);
  4308. });
  4309. </code></pre>
  4310. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  4311. <span class="hljs-keyword">const</span> headers = {
  4312. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  4313. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4314. };
  4315. fetch(<span class="hljs-string">&#x27;/api/users/{user}/boards&#x27;</span>,
  4316. {
  4317. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  4318. <span class="hljs-attr">headers</span>: headers
  4319. })
  4320. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  4321. <span class="hljs-keyword">return</span> res.json();
  4322. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  4323. <span class="hljs-built_in">console</span>.log(body);
  4324. });
  4325. </code></pre>
  4326. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  4327. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  4328. headers = {
  4329. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  4330. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4331. }
  4332. result = RestClient.get <span class="hljs-string">&#x27;/api/users/{user}/boards&#x27;</span>,
  4333. <span class="hljs-symbol">params:</span> {
  4334. }, <span class="hljs-symbol">headers:</span> headers
  4335. p JSON.parse(result)
  4336. </code></pre>
  4337. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  4338. headers = {
  4339. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  4340. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4341. }
  4342. r = requests.get(<span class="hljs-string">&#x27;/api/users/{user}/boards&#x27;</span>, headers = headers)
  4343. <span class="hljs-built_in">print</span>(r.json())
  4344. </code></pre>
  4345. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/users/{user}/boards&quot;</span>);
  4346. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  4347. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  4348. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  4349. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  4350. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  4351. String inputLine;
  4352. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  4353. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  4354. response.append(inputLine);
  4355. }
  4356. in.close();
  4357. System.out.println(response.toString());
  4358. </code></pre>
  4359. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  4360. <span class="hljs-keyword">import</span> (
  4361. <span class="hljs-string">&quot;bytes&quot;</span>
  4362. <span class="hljs-string">&quot;net/http&quot;</span>
  4363. )
  4364. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  4365. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  4366. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  4367. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  4368. }
  4369. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  4370. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/users/{user}/boards&quot;</span>, data)
  4371. req.Header = headers
  4372. client := &amp;http.Client{}
  4373. resp, err := client.Do(req)
  4374. <span class="hljs-comment">// ...</span>
  4375. }
  4376. </code></pre>
  4377. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  4378. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  4379. );
  4380. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  4381. <span class="hljs-comment">// Define array of request body.</span>
  4382. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  4383. <span class="hljs-keyword">try</span> {
  4384. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/users/{user}/boards&#x27;</span>, <span class="hljs-keyword">array</span>(
  4385. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  4386. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  4387. )
  4388. );
  4389. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  4390. }
  4391. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  4392. <span class="hljs-comment">// handle exception or api errors.</span>
  4393. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  4394. }
  4395. <span class="hljs-comment">// ...</span>
  4396. </code></pre>
  4397. <p><code>GET /api/users/{user}/boards</code></p>
  4398. <p><em>Get all boards attached to a user</em></p>
  4399. <h3 id="get_boards_from_user-parameters">Parameters</h3>
  4400. <table>
  4401. <thead>
  4402. <tr>
  4403. <th>Name</th>
  4404. <th>In</th>
  4405. <th>Type</th>
  4406. <th>Required</th>
  4407. <th>Description</th>
  4408. </tr>
  4409. </thead>
  4410. <tbody>
  4411. <tr>
  4412. <td>user</td>
  4413. <td>path</td>
  4414. <td>string</td>
  4415. <td>true</td>
  4416. <td>the ID of the user to retrieve the data</td>
  4417. </tr>
  4418. </tbody>
  4419. </table>
  4420. <h4 id="detailed-descriptions-8">Detailed descriptions</h4>
  4421. <p><strong>user</strong>: the ID of the user to retrieve the data</p>
  4422. <blockquote>
  4423. <p>Example responses</p>
  4424. </blockquote>
  4425. <blockquote>
  4426. <p>200 Response</p>
  4427. </blockquote>
  4428. <pre class="highlight tab tab-json"><code>[
  4429. {
  4430. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  4431. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  4432. }
  4433. ]
  4434. </code></pre>
  4435. <h3 id="get_boards_from_user-responses">Responses</h3>
  4436. <table>
  4437. <thead>
  4438. <tr>
  4439. <th>Status</th>
  4440. <th>Meaning</th>
  4441. <th>Description</th>
  4442. <th>Schema</th>
  4443. </tr>
  4444. </thead>
  4445. <tbody>
  4446. <tr>
  4447. <td>200</td>
  4448. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  4449. <td>200 response</td>
  4450. <td>Inline</td>
  4451. </tr>
  4452. </tbody>
  4453. </table>
  4454. <h3 id="get_boards_from_user-responseschema">Response Schema</h3>
  4455. <p>Status Code <strong>200</strong></p>
  4456. <table>
  4457. <thead>
  4458. <tr>
  4459. <th>Name</th>
  4460. <th>Type</th>
  4461. <th>Required</th>
  4462. <th>Restrictions</th>
  4463. <th>Description</th>
  4464. </tr>
  4465. </thead>
  4466. <tbody>
  4467. <tr>
  4468. <td>» _id</td>
  4469. <td>string</td>
  4470. <td>false</td>
  4471. <td>none</td>
  4472. <td>none</td>
  4473. </tr>
  4474. <tr>
  4475. <td>» title</td>
  4476. <td>string</td>
  4477. <td>false</td>
  4478. <td>none</td>
  4479. <td>none</td>
  4480. </tr>
  4481. </tbody>
  4482. </table>
  4483. <aside class="warning">
  4484. To perform this operation, you must be authenticated by means of one of the following methods:
  4485. UserSecurity
  4486. </aside>
  4487. <h1 id="wekan-rest-api-checklists">Checklists</h1>
  4488. <h2 id="get_all_checklists">get_all_checklists</h2>
  4489. <p><a id="opIdget_all_checklists"></a></p>
  4490. <blockquote>
  4491. <p>Code samples</p>
  4492. </blockquote>
  4493. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  4494. curl -X GET /api/boards/{board}/cards/{card}/checklists \
  4495. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  4496. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  4497. </code></pre>
  4498. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/cards/{card}/checklists</span> <span class="hljs-meta">HTTP/1.1</span>
  4499. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  4500. </span></code></pre>
  4501. <pre class="highlight tab tab-javascript"><code>
  4502. <span class="hljs-keyword">const</span> headers = {
  4503. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  4504. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4505. };
  4506. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists&#x27;</span>,
  4507. {
  4508. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  4509. <span class="hljs-attr">headers</span>: headers
  4510. })
  4511. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  4512. <span class="hljs-keyword">return</span> res.json();
  4513. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  4514. <span class="hljs-built_in">console</span>.log(body);
  4515. });
  4516. </code></pre>
  4517. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  4518. <span class="hljs-keyword">const</span> headers = {
  4519. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  4520. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4521. };
  4522. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists&#x27;</span>,
  4523. {
  4524. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  4525. <span class="hljs-attr">headers</span>: headers
  4526. })
  4527. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  4528. <span class="hljs-keyword">return</span> res.json();
  4529. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  4530. <span class="hljs-built_in">console</span>.log(body);
  4531. });
  4532. </code></pre>
  4533. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  4534. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  4535. headers = {
  4536. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  4537. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4538. }
  4539. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists&#x27;</span>,
  4540. <span class="hljs-symbol">params:</span> {
  4541. }, <span class="hljs-symbol">headers:</span> headers
  4542. p JSON.parse(result)
  4543. </code></pre>
  4544. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  4545. headers = {
  4546. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  4547. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4548. }
  4549. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists&#x27;</span>, headers = headers)
  4550. <span class="hljs-built_in">print</span>(r.json())
  4551. </code></pre>
  4552. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/checklists&quot;</span>);
  4553. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  4554. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  4555. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  4556. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  4557. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  4558. String inputLine;
  4559. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  4560. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  4561. response.append(inputLine);
  4562. }
  4563. in.close();
  4564. System.out.println(response.toString());
  4565. </code></pre>
  4566. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  4567. <span class="hljs-keyword">import</span> (
  4568. <span class="hljs-string">&quot;bytes&quot;</span>
  4569. <span class="hljs-string">&quot;net/http&quot;</span>
  4570. )
  4571. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  4572. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  4573. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  4574. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  4575. }
  4576. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  4577. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/checklists&quot;</span>, data)
  4578. req.Header = headers
  4579. client := &amp;http.Client{}
  4580. resp, err := client.Do(req)
  4581. <span class="hljs-comment">// ...</span>
  4582. }
  4583. </code></pre>
  4584. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  4585. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  4586. );
  4587. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  4588. <span class="hljs-comment">// Define array of request body.</span>
  4589. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  4590. <span class="hljs-keyword">try</span> {
  4591. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists&#x27;</span>, <span class="hljs-keyword">array</span>(
  4592. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  4593. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  4594. )
  4595. );
  4596. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  4597. }
  4598. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  4599. <span class="hljs-comment">// handle exception or api errors.</span>
  4600. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  4601. }
  4602. <span class="hljs-comment">// ...</span>
  4603. </code></pre>
  4604. <p><code>GET /api/boards/{board}/cards/{card}/checklists</code></p>
  4605. <p><em>Get the list of checklists attached to a card</em></p>
  4606. <h3 id="get_all_checklists-parameters">Parameters</h3>
  4607. <table>
  4608. <thead>
  4609. <tr>
  4610. <th>Name</th>
  4611. <th>In</th>
  4612. <th>Type</th>
  4613. <th>Required</th>
  4614. <th>Description</th>
  4615. </tr>
  4616. </thead>
  4617. <tbody>
  4618. <tr>
  4619. <td>board</td>
  4620. <td>path</td>
  4621. <td>string</td>
  4622. <td>true</td>
  4623. <td>the board ID</td>
  4624. </tr>
  4625. <tr>
  4626. <td>card</td>
  4627. <td>path</td>
  4628. <td>string</td>
  4629. <td>true</td>
  4630. <td>the card ID</td>
  4631. </tr>
  4632. </tbody>
  4633. </table>
  4634. <h4 id="detailed-descriptions-9">Detailed descriptions</h4>
  4635. <p><strong>board</strong>: the board ID</p>
  4636. <p><strong>card</strong>: the card ID</p>
  4637. <blockquote>
  4638. <p>Example responses</p>
  4639. </blockquote>
  4640. <blockquote>
  4641. <p>200 Response</p>
  4642. </blockquote>
  4643. <pre class="highlight tab tab-json"><code>[
  4644. {
  4645. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  4646. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  4647. }
  4648. ]
  4649. </code></pre>
  4650. <h3 id="get_all_checklists-responses">Responses</h3>
  4651. <table>
  4652. <thead>
  4653. <tr>
  4654. <th>Status</th>
  4655. <th>Meaning</th>
  4656. <th>Description</th>
  4657. <th>Schema</th>
  4658. </tr>
  4659. </thead>
  4660. <tbody>
  4661. <tr>
  4662. <td>200</td>
  4663. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  4664. <td>200 response</td>
  4665. <td>Inline</td>
  4666. </tr>
  4667. </tbody>
  4668. </table>
  4669. <h3 id="get_all_checklists-responseschema">Response Schema</h3>
  4670. <p>Status Code <strong>200</strong></p>
  4671. <table>
  4672. <thead>
  4673. <tr>
  4674. <th>Name</th>
  4675. <th>Type</th>
  4676. <th>Required</th>
  4677. <th>Restrictions</th>
  4678. <th>Description</th>
  4679. </tr>
  4680. </thead>
  4681. <tbody>
  4682. <tr>
  4683. <td>» _id</td>
  4684. <td>string</td>
  4685. <td>false</td>
  4686. <td>none</td>
  4687. <td>none</td>
  4688. </tr>
  4689. <tr>
  4690. <td>» title</td>
  4691. <td>string</td>
  4692. <td>false</td>
  4693. <td>none</td>
  4694. <td>none</td>
  4695. </tr>
  4696. </tbody>
  4697. </table>
  4698. <aside class="warning">
  4699. To perform this operation, you must be authenticated by means of one of the following methods:
  4700. UserSecurity
  4701. </aside>
  4702. <h2 id="new_checklist">new_checklist</h2>
  4703. <p><a id="opIdnew_checklist"></a></p>
  4704. <blockquote>
  4705. <p>Code samples</p>
  4706. </blockquote>
  4707. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  4708. curl -X POST /api/boards/{board}/cards/{card}/checklists \
  4709. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  4710. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  4711. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  4712. </code></pre>
  4713. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/boards/{board}/cards/{card}/checklists</span> <span class="hljs-meta">HTTP/1.1</span>
  4714. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  4715. Accept: application/json
  4716. </span></code></pre>
  4717. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  4718. &quot;title&quot;: &quot;string&quot;,
  4719. &quot;items&quot;: &quot;string&quot;
  4720. }&#x27;</span>;
  4721. <span class="hljs-keyword">const</span> headers = {
  4722. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  4723. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  4724. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4725. };
  4726. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists&#x27;</span>,
  4727. {
  4728. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  4729. <span class="hljs-attr">body</span>: inputBody,
  4730. <span class="hljs-attr">headers</span>: headers
  4731. })
  4732. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  4733. <span class="hljs-keyword">return</span> res.json();
  4734. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  4735. <span class="hljs-built_in">console</span>.log(body);
  4736. });
  4737. </code></pre>
  4738. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  4739. <span class="hljs-keyword">const</span> inputBody = {
  4740. <span class="hljs-string">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  4741. <span class="hljs-string">&quot;items&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  4742. };
  4743. <span class="hljs-keyword">const</span> headers = {
  4744. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  4745. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  4746. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4747. };
  4748. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists&#x27;</span>,
  4749. {
  4750. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  4751. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  4752. <span class="hljs-attr">headers</span>: headers
  4753. })
  4754. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  4755. <span class="hljs-keyword">return</span> res.json();
  4756. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  4757. <span class="hljs-built_in">console</span>.log(body);
  4758. });
  4759. </code></pre>
  4760. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  4761. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  4762. headers = {
  4763. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  4764. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  4765. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4766. }
  4767. result = RestClient.post <span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists&#x27;</span>,
  4768. <span class="hljs-symbol">params:</span> {
  4769. }, <span class="hljs-symbol">headers:</span> headers
  4770. p JSON.parse(result)
  4771. </code></pre>
  4772. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  4773. headers = {
  4774. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  4775. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  4776. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4777. }
  4778. r = requests.post(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists&#x27;</span>, headers = headers)
  4779. <span class="hljs-built_in">print</span>(r.json())
  4780. </code></pre>
  4781. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/checklists&quot;</span>);
  4782. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  4783. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  4784. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  4785. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  4786. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  4787. String inputLine;
  4788. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  4789. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  4790. response.append(inputLine);
  4791. }
  4792. in.close();
  4793. System.out.println(response.toString());
  4794. </code></pre>
  4795. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  4796. <span class="hljs-keyword">import</span> (
  4797. <span class="hljs-string">&quot;bytes&quot;</span>
  4798. <span class="hljs-string">&quot;net/http&quot;</span>
  4799. )
  4800. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  4801. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  4802. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  4803. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  4804. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  4805. }
  4806. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  4807. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/checklists&quot;</span>, data)
  4808. req.Header = headers
  4809. client := &amp;http.Client{}
  4810. resp, err := client.Do(req)
  4811. <span class="hljs-comment">// ...</span>
  4812. }
  4813. </code></pre>
  4814. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  4815. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  4816. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  4817. );
  4818. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  4819. <span class="hljs-comment">// Define array of request body.</span>
  4820. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  4821. <span class="hljs-keyword">try</span> {
  4822. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists&#x27;</span>, <span class="hljs-keyword">array</span>(
  4823. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  4824. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  4825. )
  4826. );
  4827. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  4828. }
  4829. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  4830. <span class="hljs-comment">// handle exception or api errors.</span>
  4831. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  4832. }
  4833. <span class="hljs-comment">// ...</span>
  4834. </code></pre>
  4835. <p><code>POST /api/boards/{board}/cards/{card}/checklists</code></p>
  4836. <p><em>create a new checklist</em></p>
  4837. <blockquote>
  4838. <p>Body parameter</p>
  4839. </blockquote>
  4840. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">title:</span> <span class="hljs-string">string</span>
  4841. <span class="hljs-attr">items:</span> <span class="hljs-string">string</span>
  4842. </code></pre>
  4843. <h3 id="new_checklist-parameters">Parameters</h3>
  4844. <table>
  4845. <thead>
  4846. <tr>
  4847. <th>Name</th>
  4848. <th>In</th>
  4849. <th>Type</th>
  4850. <th>Required</th>
  4851. <th>Description</th>
  4852. </tr>
  4853. </thead>
  4854. <tbody>
  4855. <tr>
  4856. <td>board</td>
  4857. <td>path</td>
  4858. <td>string</td>
  4859. <td>true</td>
  4860. <td>the board ID</td>
  4861. </tr>
  4862. <tr>
  4863. <td>card</td>
  4864. <td>path</td>
  4865. <td>string</td>
  4866. <td>true</td>
  4867. <td>the card ID</td>
  4868. </tr>
  4869. <tr>
  4870. <td>body</td>
  4871. <td>body</td>
  4872. <td>object</td>
  4873. <td>true</td>
  4874. <td>none</td>
  4875. </tr>
  4876. <tr>
  4877. <td>» title</td>
  4878. <td>body</td>
  4879. <td>string</td>
  4880. <td>true</td>
  4881. <td>the title of the new checklist</td>
  4882. </tr>
  4883. <tr>
  4884. <td>» items</td>
  4885. <td>body</td>
  4886. <td>string</td>
  4887. <td>false</td>
  4888. <td>the list of items on the new checklist</td>
  4889. </tr>
  4890. </tbody>
  4891. </table>
  4892. <h4 id="detailed-descriptions-10">Detailed descriptions</h4>
  4893. <p><strong>board</strong>: the board ID</p>
  4894. <p><strong>card</strong>: the card ID</p>
  4895. <blockquote>
  4896. <p>Example responses</p>
  4897. </blockquote>
  4898. <blockquote>
  4899. <p>200 Response</p>
  4900. </blockquote>
  4901. <pre class="highlight tab tab-json"><code>{
  4902. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  4903. }
  4904. </code></pre>
  4905. <h3 id="new_checklist-responses">Responses</h3>
  4906. <table>
  4907. <thead>
  4908. <tr>
  4909. <th>Status</th>
  4910. <th>Meaning</th>
  4911. <th>Description</th>
  4912. <th>Schema</th>
  4913. </tr>
  4914. </thead>
  4915. <tbody>
  4916. <tr>
  4917. <td>200</td>
  4918. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  4919. <td>200 response</td>
  4920. <td>Inline</td>
  4921. </tr>
  4922. </tbody>
  4923. </table>
  4924. <h3 id="new_checklist-responseschema">Response Schema</h3>
  4925. <p>Status Code <strong>200</strong></p>
  4926. <table>
  4927. <thead>
  4928. <tr>
  4929. <th>Name</th>
  4930. <th>Type</th>
  4931. <th>Required</th>
  4932. <th>Restrictions</th>
  4933. <th>Description</th>
  4934. </tr>
  4935. </thead>
  4936. <tbody>
  4937. <tr>
  4938. <td>» _id</td>
  4939. <td>string</td>
  4940. <td>false</td>
  4941. <td>none</td>
  4942. <td>none</td>
  4943. </tr>
  4944. </tbody>
  4945. </table>
  4946. <aside class="warning">
  4947. To perform this operation, you must be authenticated by means of one of the following methods:
  4948. UserSecurity
  4949. </aside>
  4950. <h2 id="get_checklist">get_checklist</h2>
  4951. <p><a id="opIdget_checklist"></a></p>
  4952. <blockquote>
  4953. <p>Code samples</p>
  4954. </blockquote>
  4955. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  4956. curl -X GET /api/boards/{board}/cards/{card}/checklists/{checklist} \
  4957. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  4958. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  4959. </code></pre>
  4960. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/cards/{card}/checklists/{checklist}</span> <span class="hljs-meta">HTTP/1.1</span>
  4961. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  4962. </span></code></pre>
  4963. <pre class="highlight tab tab-javascript"><code>
  4964. <span class="hljs-keyword">const</span> headers = {
  4965. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  4966. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4967. };
  4968. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}&#x27;</span>,
  4969. {
  4970. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  4971. <span class="hljs-attr">headers</span>: headers
  4972. })
  4973. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  4974. <span class="hljs-keyword">return</span> res.json();
  4975. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  4976. <span class="hljs-built_in">console</span>.log(body);
  4977. });
  4978. </code></pre>
  4979. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  4980. <span class="hljs-keyword">const</span> headers = {
  4981. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  4982. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  4983. };
  4984. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}&#x27;</span>,
  4985. {
  4986. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  4987. <span class="hljs-attr">headers</span>: headers
  4988. })
  4989. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  4990. <span class="hljs-keyword">return</span> res.json();
  4991. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  4992. <span class="hljs-built_in">console</span>.log(body);
  4993. });
  4994. </code></pre>
  4995. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  4996. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  4997. headers = {
  4998. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  4999. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5000. }
  5001. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}&#x27;</span>,
  5002. <span class="hljs-symbol">params:</span> {
  5003. }, <span class="hljs-symbol">headers:</span> headers
  5004. p JSON.parse(result)
  5005. </code></pre>
  5006. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  5007. headers = {
  5008. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  5009. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5010. }
  5011. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}&#x27;</span>, headers = headers)
  5012. <span class="hljs-built_in">print</span>(r.json())
  5013. </code></pre>
  5014. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/checklists/{checklist}&quot;</span>);
  5015. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  5016. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  5017. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  5018. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  5019. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  5020. String inputLine;
  5021. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  5022. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  5023. response.append(inputLine);
  5024. }
  5025. in.close();
  5026. System.out.println(response.toString());
  5027. </code></pre>
  5028. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  5029. <span class="hljs-keyword">import</span> (
  5030. <span class="hljs-string">&quot;bytes&quot;</span>
  5031. <span class="hljs-string">&quot;net/http&quot;</span>
  5032. )
  5033. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  5034. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  5035. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  5036. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  5037. }
  5038. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  5039. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/checklists/{checklist}&quot;</span>, data)
  5040. req.Header = headers
  5041. client := &amp;http.Client{}
  5042. resp, err := client.Do(req)
  5043. <span class="hljs-comment">// ...</span>
  5044. }
  5045. </code></pre>
  5046. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  5047. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  5048. );
  5049. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  5050. <span class="hljs-comment">// Define array of request body.</span>
  5051. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  5052. <span class="hljs-keyword">try</span> {
  5053. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}&#x27;</span>, <span class="hljs-keyword">array</span>(
  5054. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  5055. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  5056. )
  5057. );
  5058. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  5059. }
  5060. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  5061. <span class="hljs-comment">// handle exception or api errors.</span>
  5062. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  5063. }
  5064. <span class="hljs-comment">// ...</span>
  5065. </code></pre>
  5066. <p><code>GET /api/boards/{board}/cards/{card}/checklists/{checklist}</code></p>
  5067. <p><em>Get a checklist</em></p>
  5068. <h3 id="get_checklist-parameters">Parameters</h3>
  5069. <table>
  5070. <thead>
  5071. <tr>
  5072. <th>Name</th>
  5073. <th>In</th>
  5074. <th>Type</th>
  5075. <th>Required</th>
  5076. <th>Description</th>
  5077. </tr>
  5078. </thead>
  5079. <tbody>
  5080. <tr>
  5081. <td>board</td>
  5082. <td>path</td>
  5083. <td>string</td>
  5084. <td>true</td>
  5085. <td>the board ID</td>
  5086. </tr>
  5087. <tr>
  5088. <td>card</td>
  5089. <td>path</td>
  5090. <td>string</td>
  5091. <td>true</td>
  5092. <td>the card ID</td>
  5093. </tr>
  5094. <tr>
  5095. <td>checklist</td>
  5096. <td>path</td>
  5097. <td>string</td>
  5098. <td>true</td>
  5099. <td>the ID of the checklist</td>
  5100. </tr>
  5101. </tbody>
  5102. </table>
  5103. <h4 id="detailed-descriptions-11">Detailed descriptions</h4>
  5104. <p><strong>board</strong>: the board ID</p>
  5105. <p><strong>card</strong>: the card ID</p>
  5106. <p><strong>checklist</strong>: the ID of the checklist</p>
  5107. <blockquote>
  5108. <p>Example responses</p>
  5109. </blockquote>
  5110. <blockquote>
  5111. <p>200 Response</p>
  5112. </blockquote>
  5113. <pre class="highlight tab tab-json"><code>{
  5114. <span class="hljs-attr">&quot;cardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  5115. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  5116. <span class="hljs-attr">&quot;finishedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  5117. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  5118. <span class="hljs-attr">&quot;sort&quot;</span>: <span class="hljs-number">0</span>,
  5119. <span class="hljs-attr">&quot;items&quot;</span>: [
  5120. {
  5121. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  5122. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  5123. <span class="hljs-attr">&quot;isFinished&quot;</span>: <span class="hljs-literal">true</span>
  5124. }
  5125. ]
  5126. }
  5127. </code></pre>
  5128. <h3 id="get_checklist-responses">Responses</h3>
  5129. <table>
  5130. <thead>
  5131. <tr>
  5132. <th>Status</th>
  5133. <th>Meaning</th>
  5134. <th>Description</th>
  5135. <th>Schema</th>
  5136. </tr>
  5137. </thead>
  5138. <tbody>
  5139. <tr>
  5140. <td>200</td>
  5141. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  5142. <td>200 response</td>
  5143. <td>Inline</td>
  5144. </tr>
  5145. </tbody>
  5146. </table>
  5147. <h3 id="get_checklist-responseschema">Response Schema</h3>
  5148. <p>Status Code <strong>200</strong></p>
  5149. <table>
  5150. <thead>
  5151. <tr>
  5152. <th>Name</th>
  5153. <th>Type</th>
  5154. <th>Required</th>
  5155. <th>Restrictions</th>
  5156. <th>Description</th>
  5157. </tr>
  5158. </thead>
  5159. <tbody>
  5160. <tr>
  5161. <td>» cardId</td>
  5162. <td>string</td>
  5163. <td>false</td>
  5164. <td>none</td>
  5165. <td>none</td>
  5166. </tr>
  5167. <tr>
  5168. <td>» title</td>
  5169. <td>string</td>
  5170. <td>false</td>
  5171. <td>none</td>
  5172. <td>none</td>
  5173. </tr>
  5174. <tr>
  5175. <td>» finishedAt</td>
  5176. <td>string</td>
  5177. <td>false</td>
  5178. <td>none</td>
  5179. <td>none</td>
  5180. </tr>
  5181. <tr>
  5182. <td>» createdAt</td>
  5183. <td>string</td>
  5184. <td>false</td>
  5185. <td>none</td>
  5186. <td>none</td>
  5187. </tr>
  5188. <tr>
  5189. <td>» sort</td>
  5190. <td>number</td>
  5191. <td>false</td>
  5192. <td>none</td>
  5193. <td>none</td>
  5194. </tr>
  5195. <tr>
  5196. <td>» items</td>
  5197. <td>[object]</td>
  5198. <td>false</td>
  5199. <td>none</td>
  5200. <td>none</td>
  5201. </tr>
  5202. <tr>
  5203. <td>»» _id</td>
  5204. <td>string</td>
  5205. <td>false</td>
  5206. <td>none</td>
  5207. <td>none</td>
  5208. </tr>
  5209. <tr>
  5210. <td>»» title</td>
  5211. <td>string</td>
  5212. <td>false</td>
  5213. <td>none</td>
  5214. <td>none</td>
  5215. </tr>
  5216. <tr>
  5217. <td>»» isFinished</td>
  5218. <td>boolean</td>
  5219. <td>false</td>
  5220. <td>none</td>
  5221. <td>none</td>
  5222. </tr>
  5223. </tbody>
  5224. </table>
  5225. <aside class="warning">
  5226. To perform this operation, you must be authenticated by means of one of the following methods:
  5227. UserSecurity
  5228. </aside>
  5229. <h2 id="delete_checklist">delete_checklist</h2>
  5230. <p><a id="opIddelete_checklist"></a></p>
  5231. <blockquote>
  5232. <p>Code samples</p>
  5233. </blockquote>
  5234. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  5235. curl -X DELETE /api/boards/{board}/cards/{card}/checklists/{checklist} \
  5236. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  5237. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  5238. </code></pre>
  5239. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">DELETE</span> <span class="hljs-string">/api/boards/{board}/cards/{card}/checklists/{checklist}</span> <span class="hljs-meta">HTTP/1.1</span>
  5240. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  5241. </span></code></pre>
  5242. <pre class="highlight tab tab-javascript"><code>
  5243. <span class="hljs-keyword">const</span> headers = {
  5244. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  5245. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5246. };
  5247. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}&#x27;</span>,
  5248. {
  5249. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  5250. <span class="hljs-attr">headers</span>: headers
  5251. })
  5252. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  5253. <span class="hljs-keyword">return</span> res.json();
  5254. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  5255. <span class="hljs-built_in">console</span>.log(body);
  5256. });
  5257. </code></pre>
  5258. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  5259. <span class="hljs-keyword">const</span> headers = {
  5260. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  5261. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5262. };
  5263. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}&#x27;</span>,
  5264. {
  5265. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  5266. <span class="hljs-attr">headers</span>: headers
  5267. })
  5268. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  5269. <span class="hljs-keyword">return</span> res.json();
  5270. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  5271. <span class="hljs-built_in">console</span>.log(body);
  5272. });
  5273. </code></pre>
  5274. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  5275. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  5276. headers = {
  5277. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  5278. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5279. }
  5280. result = RestClient.delete <span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}&#x27;</span>,
  5281. <span class="hljs-symbol">params:</span> {
  5282. }, <span class="hljs-symbol">headers:</span> headers
  5283. p JSON.parse(result)
  5284. </code></pre>
  5285. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  5286. headers = {
  5287. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  5288. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5289. }
  5290. r = requests.delete(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}&#x27;</span>, headers = headers)
  5291. <span class="hljs-built_in">print</span>(r.json())
  5292. </code></pre>
  5293. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/checklists/{checklist}&quot;</span>);
  5294. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  5295. con.setRequestMethod(<span class="hljs-string">&quot;DELETE&quot;</span>);
  5296. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  5297. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  5298. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  5299. String inputLine;
  5300. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  5301. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  5302. response.append(inputLine);
  5303. }
  5304. in.close();
  5305. System.out.println(response.toString());
  5306. </code></pre>
  5307. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  5308. <span class="hljs-keyword">import</span> (
  5309. <span class="hljs-string">&quot;bytes&quot;</span>
  5310. <span class="hljs-string">&quot;net/http&quot;</span>
  5311. )
  5312. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  5313. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  5314. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  5315. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  5316. }
  5317. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  5318. req, err := http.NewRequest(<span class="hljs-string">&quot;DELETE&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/checklists/{checklist}&quot;</span>, data)
  5319. req.Header = headers
  5320. client := &amp;http.Client{}
  5321. resp, err := client.Do(req)
  5322. <span class="hljs-comment">// ...</span>
  5323. }
  5324. </code></pre>
  5325. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  5326. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  5327. );
  5328. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  5329. <span class="hljs-comment">// Define array of request body.</span>
  5330. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  5331. <span class="hljs-keyword">try</span> {
  5332. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;DELETE&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}&#x27;</span>, <span class="hljs-keyword">array</span>(
  5333. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  5334. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  5335. )
  5336. );
  5337. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  5338. }
  5339. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  5340. <span class="hljs-comment">// handle exception or api errors.</span>
  5341. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  5342. }
  5343. <span class="hljs-comment">// ...</span>
  5344. </code></pre>
  5345. <p><code>DELETE /api/boards/{board}/cards/{card}/checklists/{checklist}</code></p>
  5346. <p><em>Delete a checklist</em></p>
  5347. <p>The checklist will be removed, not put in the recycle bin.</p>
  5348. <h3 id="delete_checklist-parameters">Parameters</h3>
  5349. <table>
  5350. <thead>
  5351. <tr>
  5352. <th>Name</th>
  5353. <th>In</th>
  5354. <th>Type</th>
  5355. <th>Required</th>
  5356. <th>Description</th>
  5357. </tr>
  5358. </thead>
  5359. <tbody>
  5360. <tr>
  5361. <td>board</td>
  5362. <td>path</td>
  5363. <td>string</td>
  5364. <td>true</td>
  5365. <td>the board ID</td>
  5366. </tr>
  5367. <tr>
  5368. <td>card</td>
  5369. <td>path</td>
  5370. <td>string</td>
  5371. <td>true</td>
  5372. <td>the card ID</td>
  5373. </tr>
  5374. <tr>
  5375. <td>checklist</td>
  5376. <td>path</td>
  5377. <td>string</td>
  5378. <td>true</td>
  5379. <td>the ID of the checklist to remove</td>
  5380. </tr>
  5381. </tbody>
  5382. </table>
  5383. <h4 id="detailed-descriptions-12">Detailed descriptions</h4>
  5384. <p><strong>board</strong>: the board ID</p>
  5385. <p><strong>card</strong>: the card ID</p>
  5386. <p><strong>checklist</strong>: the ID of the checklist to remove</p>
  5387. <blockquote>
  5388. <p>Example responses</p>
  5389. </blockquote>
  5390. <blockquote>
  5391. <p>200 Response</p>
  5392. </blockquote>
  5393. <pre class="highlight tab tab-json"><code>{
  5394. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  5395. }
  5396. </code></pre>
  5397. <h3 id="delete_checklist-responses">Responses</h3>
  5398. <table>
  5399. <thead>
  5400. <tr>
  5401. <th>Status</th>
  5402. <th>Meaning</th>
  5403. <th>Description</th>
  5404. <th>Schema</th>
  5405. </tr>
  5406. </thead>
  5407. <tbody>
  5408. <tr>
  5409. <td>200</td>
  5410. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  5411. <td>200 response</td>
  5412. <td>Inline</td>
  5413. </tr>
  5414. </tbody>
  5415. </table>
  5416. <h3 id="delete_checklist-responseschema">Response Schema</h3>
  5417. <p>Status Code <strong>200</strong></p>
  5418. <table>
  5419. <thead>
  5420. <tr>
  5421. <th>Name</th>
  5422. <th>Type</th>
  5423. <th>Required</th>
  5424. <th>Restrictions</th>
  5425. <th>Description</th>
  5426. </tr>
  5427. </thead>
  5428. <tbody>
  5429. <tr>
  5430. <td>» _id</td>
  5431. <td>string</td>
  5432. <td>false</td>
  5433. <td>none</td>
  5434. <td>none</td>
  5435. </tr>
  5436. </tbody>
  5437. </table>
  5438. <aside class="warning">
  5439. To perform this operation, you must be authenticated by means of one of the following methods:
  5440. UserSecurity
  5441. </aside>
  5442. <h1 id="wekan-rest-api-checklistitems">ChecklistItems</h1>
  5443. <h2 id="new_checklist_item">new_checklist_item</h2>
  5444. <p><a id="opIdnew_checklist_item"></a></p>
  5445. <blockquote>
  5446. <p>Code samples</p>
  5447. </blockquote>
  5448. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  5449. curl -X POST /api/boards/{board}/cards/{card}/checklists/{checklist}/items \
  5450. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  5451. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  5452. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  5453. </code></pre>
  5454. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/boards/{board}/cards/{card}/checklists/{checklist}/items</span> <span class="hljs-meta">HTTP/1.1</span>
  5455. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  5456. Accept: application/json
  5457. </span></code></pre>
  5458. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  5459. &quot;title&quot;: &quot;string&quot;
  5460. }&#x27;</span>;
  5461. <span class="hljs-keyword">const</span> headers = {
  5462. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  5463. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  5464. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5465. };
  5466. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items&#x27;</span>,
  5467. {
  5468. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  5469. <span class="hljs-attr">body</span>: inputBody,
  5470. <span class="hljs-attr">headers</span>: headers
  5471. })
  5472. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  5473. <span class="hljs-keyword">return</span> res.json();
  5474. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  5475. <span class="hljs-built_in">console</span>.log(body);
  5476. });
  5477. </code></pre>
  5478. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  5479. <span class="hljs-keyword">const</span> inputBody = {
  5480. <span class="hljs-string">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  5481. };
  5482. <span class="hljs-keyword">const</span> headers = {
  5483. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  5484. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  5485. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5486. };
  5487. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items&#x27;</span>,
  5488. {
  5489. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  5490. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  5491. <span class="hljs-attr">headers</span>: headers
  5492. })
  5493. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  5494. <span class="hljs-keyword">return</span> res.json();
  5495. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  5496. <span class="hljs-built_in">console</span>.log(body);
  5497. });
  5498. </code></pre>
  5499. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  5500. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  5501. headers = {
  5502. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  5503. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  5504. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5505. }
  5506. result = RestClient.post <span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items&#x27;</span>,
  5507. <span class="hljs-symbol">params:</span> {
  5508. }, <span class="hljs-symbol">headers:</span> headers
  5509. p JSON.parse(result)
  5510. </code></pre>
  5511. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  5512. headers = {
  5513. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  5514. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  5515. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5516. }
  5517. r = requests.post(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items&#x27;</span>, headers = headers)
  5518. <span class="hljs-built_in">print</span>(r.json())
  5519. </code></pre>
  5520. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/checklists/{checklist}/items&quot;</span>);
  5521. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  5522. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  5523. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  5524. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  5525. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  5526. String inputLine;
  5527. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  5528. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  5529. response.append(inputLine);
  5530. }
  5531. in.close();
  5532. System.out.println(response.toString());
  5533. </code></pre>
  5534. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  5535. <span class="hljs-keyword">import</span> (
  5536. <span class="hljs-string">&quot;bytes&quot;</span>
  5537. <span class="hljs-string">&quot;net/http&quot;</span>
  5538. )
  5539. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  5540. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  5541. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  5542. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  5543. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  5544. }
  5545. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  5546. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/checklists/{checklist}/items&quot;</span>, data)
  5547. req.Header = headers
  5548. client := &amp;http.Client{}
  5549. resp, err := client.Do(req)
  5550. <span class="hljs-comment">// ...</span>
  5551. }
  5552. </code></pre>
  5553. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  5554. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  5555. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  5556. );
  5557. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  5558. <span class="hljs-comment">// Define array of request body.</span>
  5559. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  5560. <span class="hljs-keyword">try</span> {
  5561. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items&#x27;</span>, <span class="hljs-keyword">array</span>(
  5562. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  5563. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  5564. )
  5565. );
  5566. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  5567. }
  5568. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  5569. <span class="hljs-comment">// handle exception or api errors.</span>
  5570. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  5571. }
  5572. <span class="hljs-comment">// ...</span>
  5573. </code></pre>
  5574. <p><code>POST /api/boards/{board}/cards/{card}/checklists/{checklist}/items</code></p>
  5575. <p><em>add a new item to a checklist</em></p>
  5576. <blockquote>
  5577. <p>Body parameter</p>
  5578. </blockquote>
  5579. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">title:</span> <span class="hljs-string">string</span>
  5580. </code></pre>
  5581. <h3 id="new_checklist_item-parameters">Parameters</h3>
  5582. <table>
  5583. <thead>
  5584. <tr>
  5585. <th>Name</th>
  5586. <th>In</th>
  5587. <th>Type</th>
  5588. <th>Required</th>
  5589. <th>Description</th>
  5590. </tr>
  5591. </thead>
  5592. <tbody>
  5593. <tr>
  5594. <td>board</td>
  5595. <td>path</td>
  5596. <td>string</td>
  5597. <td>true</td>
  5598. <td>the board ID</td>
  5599. </tr>
  5600. <tr>
  5601. <td>card</td>
  5602. <td>path</td>
  5603. <td>string</td>
  5604. <td>true</td>
  5605. <td>the card ID</td>
  5606. </tr>
  5607. <tr>
  5608. <td>checklist</td>
  5609. <td>path</td>
  5610. <td>string</td>
  5611. <td>true</td>
  5612. <td>the ID of the checklist</td>
  5613. </tr>
  5614. <tr>
  5615. <td>body</td>
  5616. <td>body</td>
  5617. <td>object</td>
  5618. <td>true</td>
  5619. <td>none</td>
  5620. </tr>
  5621. <tr>
  5622. <td>» title</td>
  5623. <td>body</td>
  5624. <td>string</td>
  5625. <td>true</td>
  5626. <td>the title of the new item</td>
  5627. </tr>
  5628. </tbody>
  5629. </table>
  5630. <h4 id="detailed-descriptions-13">Detailed descriptions</h4>
  5631. <p><strong>board</strong>: the board ID</p>
  5632. <p><strong>card</strong>: the card ID</p>
  5633. <p><strong>checklist</strong>: the ID of the checklist</p>
  5634. <blockquote>
  5635. <p>Example responses</p>
  5636. </blockquote>
  5637. <blockquote>
  5638. <p>200 Response</p>
  5639. </blockquote>
  5640. <pre class="highlight tab tab-json"><code>{
  5641. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  5642. }
  5643. </code></pre>
  5644. <h3 id="new_checklist_item-responses">Responses</h3>
  5645. <table>
  5646. <thead>
  5647. <tr>
  5648. <th>Status</th>
  5649. <th>Meaning</th>
  5650. <th>Description</th>
  5651. <th>Schema</th>
  5652. </tr>
  5653. </thead>
  5654. <tbody>
  5655. <tr>
  5656. <td>200</td>
  5657. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  5658. <td>200 response</td>
  5659. <td>Inline</td>
  5660. </tr>
  5661. </tbody>
  5662. </table>
  5663. <h3 id="new_checklist_item-responseschema">Response Schema</h3>
  5664. <p>Status Code <strong>200</strong></p>
  5665. <table>
  5666. <thead>
  5667. <tr>
  5668. <th>Name</th>
  5669. <th>Type</th>
  5670. <th>Required</th>
  5671. <th>Restrictions</th>
  5672. <th>Description</th>
  5673. </tr>
  5674. </thead>
  5675. <tbody>
  5676. <tr>
  5677. <td>» _id</td>
  5678. <td>string</td>
  5679. <td>false</td>
  5680. <td>none</td>
  5681. <td>none</td>
  5682. </tr>
  5683. </tbody>
  5684. </table>
  5685. <aside class="warning">
  5686. To perform this operation, you must be authenticated by means of one of the following methods:
  5687. UserSecurity
  5688. </aside>
  5689. <h2 id="get_checklist_item">get_checklist_item</h2>
  5690. <p><a id="opIdget_checklist_item"></a></p>
  5691. <blockquote>
  5692. <p>Code samples</p>
  5693. </blockquote>
  5694. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  5695. curl -X GET /api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item} \
  5696. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  5697. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  5698. </code></pre>
  5699. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}</span> <span class="hljs-meta">HTTP/1.1</span>
  5700. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  5701. </span></code></pre>
  5702. <pre class="highlight tab tab-javascript"><code>
  5703. <span class="hljs-keyword">const</span> headers = {
  5704. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  5705. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5706. };
  5707. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&#x27;</span>,
  5708. {
  5709. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  5710. <span class="hljs-attr">headers</span>: headers
  5711. })
  5712. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  5713. <span class="hljs-keyword">return</span> res.json();
  5714. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  5715. <span class="hljs-built_in">console</span>.log(body);
  5716. });
  5717. </code></pre>
  5718. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  5719. <span class="hljs-keyword">const</span> headers = {
  5720. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  5721. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5722. };
  5723. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&#x27;</span>,
  5724. {
  5725. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  5726. <span class="hljs-attr">headers</span>: headers
  5727. })
  5728. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  5729. <span class="hljs-keyword">return</span> res.json();
  5730. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  5731. <span class="hljs-built_in">console</span>.log(body);
  5732. });
  5733. </code></pre>
  5734. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  5735. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  5736. headers = {
  5737. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  5738. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5739. }
  5740. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&#x27;</span>,
  5741. <span class="hljs-symbol">params:</span> {
  5742. }, <span class="hljs-symbol">headers:</span> headers
  5743. p JSON.parse(result)
  5744. </code></pre>
  5745. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  5746. headers = {
  5747. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  5748. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5749. }
  5750. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&#x27;</span>, headers = headers)
  5751. <span class="hljs-built_in">print</span>(r.json())
  5752. </code></pre>
  5753. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&quot;</span>);
  5754. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  5755. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  5756. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  5757. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  5758. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  5759. String inputLine;
  5760. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  5761. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  5762. response.append(inputLine);
  5763. }
  5764. in.close();
  5765. System.out.println(response.toString());
  5766. </code></pre>
  5767. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  5768. <span class="hljs-keyword">import</span> (
  5769. <span class="hljs-string">&quot;bytes&quot;</span>
  5770. <span class="hljs-string">&quot;net/http&quot;</span>
  5771. )
  5772. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  5773. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  5774. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  5775. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  5776. }
  5777. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  5778. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&quot;</span>, data)
  5779. req.Header = headers
  5780. client := &amp;http.Client{}
  5781. resp, err := client.Do(req)
  5782. <span class="hljs-comment">// ...</span>
  5783. }
  5784. </code></pre>
  5785. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  5786. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  5787. );
  5788. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  5789. <span class="hljs-comment">// Define array of request body.</span>
  5790. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  5791. <span class="hljs-keyword">try</span> {
  5792. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&#x27;</span>, <span class="hljs-keyword">array</span>(
  5793. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  5794. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  5795. )
  5796. );
  5797. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  5798. }
  5799. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  5800. <span class="hljs-comment">// handle exception or api errors.</span>
  5801. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  5802. }
  5803. <span class="hljs-comment">// ...</span>
  5804. </code></pre>
  5805. <p><code>GET /api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}</code></p>
  5806. <p><em>Get a checklist item</em></p>
  5807. <h3 id="get_checklist_item-parameters">Parameters</h3>
  5808. <table>
  5809. <thead>
  5810. <tr>
  5811. <th>Name</th>
  5812. <th>In</th>
  5813. <th>Type</th>
  5814. <th>Required</th>
  5815. <th>Description</th>
  5816. </tr>
  5817. </thead>
  5818. <tbody>
  5819. <tr>
  5820. <td>board</td>
  5821. <td>path</td>
  5822. <td>string</td>
  5823. <td>true</td>
  5824. <td>the board ID</td>
  5825. </tr>
  5826. <tr>
  5827. <td>card</td>
  5828. <td>path</td>
  5829. <td>string</td>
  5830. <td>true</td>
  5831. <td>the card ID</td>
  5832. </tr>
  5833. <tr>
  5834. <td>checklist</td>
  5835. <td>path</td>
  5836. <td>string</td>
  5837. <td>true</td>
  5838. <td>the checklist ID</td>
  5839. </tr>
  5840. <tr>
  5841. <td>item</td>
  5842. <td>path</td>
  5843. <td>string</td>
  5844. <td>true</td>
  5845. <td>the ID of the item</td>
  5846. </tr>
  5847. </tbody>
  5848. </table>
  5849. <h4 id="detailed-descriptions-14">Detailed descriptions</h4>
  5850. <p><strong>board</strong>: the board ID</p>
  5851. <p><strong>card</strong>: the card ID</p>
  5852. <p><strong>checklist</strong>: the checklist ID</p>
  5853. <p><strong>item</strong>: the ID of the item</p>
  5854. <blockquote>
  5855. <p>Example responses</p>
  5856. </blockquote>
  5857. <blockquote>
  5858. <p>200 Response</p>
  5859. </blockquote>
  5860. <pre class="highlight tab tab-json"><code>{
  5861. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  5862. <span class="hljs-attr">&quot;sort&quot;</span>: <span class="hljs-number">0</span>,
  5863. <span class="hljs-attr">&quot;isFinished&quot;</span>: <span class="hljs-literal">true</span>,
  5864. <span class="hljs-attr">&quot;checklistId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  5865. <span class="hljs-attr">&quot;cardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  5866. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  5867. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  5868. }
  5869. </code></pre>
  5870. <h3 id="get_checklist_item-responses">Responses</h3>
  5871. <table>
  5872. <thead>
  5873. <tr>
  5874. <th>Status</th>
  5875. <th>Meaning</th>
  5876. <th>Description</th>
  5877. <th>Schema</th>
  5878. </tr>
  5879. </thead>
  5880. <tbody>
  5881. <tr>
  5882. <td>200</td>
  5883. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  5884. <td>200 response</td>
  5885. <td><a href="#schemachecklistitems">ChecklistItems</a></td>
  5886. </tr>
  5887. </tbody>
  5888. </table>
  5889. <aside class="warning">
  5890. To perform this operation, you must be authenticated by means of one of the following methods:
  5891. UserSecurity
  5892. </aside>
  5893. <h2 id="edit_checklist_item">edit_checklist_item</h2>
  5894. <p><a id="opIdedit_checklist_item"></a></p>
  5895. <blockquote>
  5896. <p>Code samples</p>
  5897. </blockquote>
  5898. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  5899. curl -X PUT /api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item} \
  5900. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  5901. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  5902. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  5903. </code></pre>
  5904. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">PUT</span> <span class="hljs-string">/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}</span> <span class="hljs-meta">HTTP/1.1</span>
  5905. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  5906. Accept: application/json
  5907. </span></code></pre>
  5908. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  5909. &quot;isFinished&quot;: &quot;string&quot;,
  5910. &quot;title&quot;: &quot;string&quot;
  5911. }&#x27;</span>;
  5912. <span class="hljs-keyword">const</span> headers = {
  5913. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  5914. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  5915. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5916. };
  5917. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&#x27;</span>,
  5918. {
  5919. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;PUT&#x27;</span>,
  5920. <span class="hljs-attr">body</span>: inputBody,
  5921. <span class="hljs-attr">headers</span>: headers
  5922. })
  5923. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  5924. <span class="hljs-keyword">return</span> res.json();
  5925. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  5926. <span class="hljs-built_in">console</span>.log(body);
  5927. });
  5928. </code></pre>
  5929. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  5930. <span class="hljs-keyword">const</span> inputBody = {
  5931. <span class="hljs-string">&quot;isFinished&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  5932. <span class="hljs-string">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  5933. };
  5934. <span class="hljs-keyword">const</span> headers = {
  5935. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  5936. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  5937. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5938. };
  5939. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&#x27;</span>,
  5940. {
  5941. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;PUT&#x27;</span>,
  5942. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  5943. <span class="hljs-attr">headers</span>: headers
  5944. })
  5945. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  5946. <span class="hljs-keyword">return</span> res.json();
  5947. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  5948. <span class="hljs-built_in">console</span>.log(body);
  5949. });
  5950. </code></pre>
  5951. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  5952. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  5953. headers = {
  5954. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  5955. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  5956. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5957. }
  5958. result = RestClient.put <span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&#x27;</span>,
  5959. <span class="hljs-symbol">params:</span> {
  5960. }, <span class="hljs-symbol">headers:</span> headers
  5961. p JSON.parse(result)
  5962. </code></pre>
  5963. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  5964. headers = {
  5965. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  5966. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  5967. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  5968. }
  5969. r = requests.put(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&#x27;</span>, headers = headers)
  5970. <span class="hljs-built_in">print</span>(r.json())
  5971. </code></pre>
  5972. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&quot;</span>);
  5973. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  5974. con.setRequestMethod(<span class="hljs-string">&quot;PUT&quot;</span>);
  5975. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  5976. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  5977. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  5978. String inputLine;
  5979. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  5980. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  5981. response.append(inputLine);
  5982. }
  5983. in.close();
  5984. System.out.println(response.toString());
  5985. </code></pre>
  5986. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  5987. <span class="hljs-keyword">import</span> (
  5988. <span class="hljs-string">&quot;bytes&quot;</span>
  5989. <span class="hljs-string">&quot;net/http&quot;</span>
  5990. )
  5991. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  5992. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  5993. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  5994. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  5995. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  5996. }
  5997. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  5998. req, err := http.NewRequest(<span class="hljs-string">&quot;PUT&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&quot;</span>, data)
  5999. req.Header = headers
  6000. client := &amp;http.Client{}
  6001. resp, err := client.Do(req)
  6002. <span class="hljs-comment">// ...</span>
  6003. }
  6004. </code></pre>
  6005. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  6006. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  6007. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  6008. );
  6009. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  6010. <span class="hljs-comment">// Define array of request body.</span>
  6011. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  6012. <span class="hljs-keyword">try</span> {
  6013. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;PUT&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&#x27;</span>, <span class="hljs-keyword">array</span>(
  6014. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  6015. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  6016. )
  6017. );
  6018. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  6019. }
  6020. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  6021. <span class="hljs-comment">// handle exception or api errors.</span>
  6022. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  6023. }
  6024. <span class="hljs-comment">// ...</span>
  6025. </code></pre>
  6026. <p><code>PUT /api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}</code></p>
  6027. <p><em>Edit a checklist item</em></p>
  6028. <blockquote>
  6029. <p>Body parameter</p>
  6030. </blockquote>
  6031. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">isFinished:</span> <span class="hljs-string">string</span>
  6032. <span class="hljs-attr">title:</span> <span class="hljs-string">string</span>
  6033. </code></pre>
  6034. <h3 id="edit_checklist_item-parameters">Parameters</h3>
  6035. <table>
  6036. <thead>
  6037. <tr>
  6038. <th>Name</th>
  6039. <th>In</th>
  6040. <th>Type</th>
  6041. <th>Required</th>
  6042. <th>Description</th>
  6043. </tr>
  6044. </thead>
  6045. <tbody>
  6046. <tr>
  6047. <td>board</td>
  6048. <td>path</td>
  6049. <td>string</td>
  6050. <td>true</td>
  6051. <td>the board ID</td>
  6052. </tr>
  6053. <tr>
  6054. <td>card</td>
  6055. <td>path</td>
  6056. <td>string</td>
  6057. <td>true</td>
  6058. <td>the card ID</td>
  6059. </tr>
  6060. <tr>
  6061. <td>checklist</td>
  6062. <td>path</td>
  6063. <td>string</td>
  6064. <td>true</td>
  6065. <td>the checklist ID</td>
  6066. </tr>
  6067. <tr>
  6068. <td>item</td>
  6069. <td>path</td>
  6070. <td>string</td>
  6071. <td>true</td>
  6072. <td>the ID of the item</td>
  6073. </tr>
  6074. <tr>
  6075. <td>body</td>
  6076. <td>body</td>
  6077. <td>object</td>
  6078. <td>false</td>
  6079. <td>none</td>
  6080. </tr>
  6081. <tr>
  6082. <td>» isFinished</td>
  6083. <td>body</td>
  6084. <td>string</td>
  6085. <td>false</td>
  6086. <td>is the item checked?</td>
  6087. </tr>
  6088. <tr>
  6089. <td>» title</td>
  6090. <td>body</td>
  6091. <td>string</td>
  6092. <td>false</td>
  6093. <td>the new text of the item</td>
  6094. </tr>
  6095. </tbody>
  6096. </table>
  6097. <h4 id="detailed-descriptions-15">Detailed descriptions</h4>
  6098. <p><strong>board</strong>: the board ID</p>
  6099. <p><strong>card</strong>: the card ID</p>
  6100. <p><strong>checklist</strong>: the checklist ID</p>
  6101. <p><strong>item</strong>: the ID of the item</p>
  6102. <blockquote>
  6103. <p>Example responses</p>
  6104. </blockquote>
  6105. <blockquote>
  6106. <p>200 Response</p>
  6107. </blockquote>
  6108. <pre class="highlight tab tab-json"><code>{
  6109. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  6110. }
  6111. </code></pre>
  6112. <h3 id="edit_checklist_item-responses">Responses</h3>
  6113. <table>
  6114. <thead>
  6115. <tr>
  6116. <th>Status</th>
  6117. <th>Meaning</th>
  6118. <th>Description</th>
  6119. <th>Schema</th>
  6120. </tr>
  6121. </thead>
  6122. <tbody>
  6123. <tr>
  6124. <td>200</td>
  6125. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  6126. <td>200 response</td>
  6127. <td>Inline</td>
  6128. </tr>
  6129. </tbody>
  6130. </table>
  6131. <h3 id="edit_checklist_item-responseschema">Response Schema</h3>
  6132. <p>Status Code <strong>200</strong></p>
  6133. <table>
  6134. <thead>
  6135. <tr>
  6136. <th>Name</th>
  6137. <th>Type</th>
  6138. <th>Required</th>
  6139. <th>Restrictions</th>
  6140. <th>Description</th>
  6141. </tr>
  6142. </thead>
  6143. <tbody>
  6144. <tr>
  6145. <td>» _id</td>
  6146. <td>string</td>
  6147. <td>false</td>
  6148. <td>none</td>
  6149. <td>none</td>
  6150. </tr>
  6151. </tbody>
  6152. </table>
  6153. <aside class="warning">
  6154. To perform this operation, you must be authenticated by means of one of the following methods:
  6155. UserSecurity
  6156. </aside>
  6157. <h2 id="delete_checklist_item">delete_checklist_item</h2>
  6158. <p><a id="opIddelete_checklist_item"></a></p>
  6159. <blockquote>
  6160. <p>Code samples</p>
  6161. </blockquote>
  6162. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  6163. curl -X DELETE /api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item} \
  6164. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  6165. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  6166. </code></pre>
  6167. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">DELETE</span> <span class="hljs-string">/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}</span> <span class="hljs-meta">HTTP/1.1</span>
  6168. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  6169. </span></code></pre>
  6170. <pre class="highlight tab tab-javascript"><code>
  6171. <span class="hljs-keyword">const</span> headers = {
  6172. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  6173. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  6174. };
  6175. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&#x27;</span>,
  6176. {
  6177. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  6178. <span class="hljs-attr">headers</span>: headers
  6179. })
  6180. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  6181. <span class="hljs-keyword">return</span> res.json();
  6182. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  6183. <span class="hljs-built_in">console</span>.log(body);
  6184. });
  6185. </code></pre>
  6186. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  6187. <span class="hljs-keyword">const</span> headers = {
  6188. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  6189. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  6190. };
  6191. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&#x27;</span>,
  6192. {
  6193. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  6194. <span class="hljs-attr">headers</span>: headers
  6195. })
  6196. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  6197. <span class="hljs-keyword">return</span> res.json();
  6198. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  6199. <span class="hljs-built_in">console</span>.log(body);
  6200. });
  6201. </code></pre>
  6202. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  6203. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  6204. headers = {
  6205. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  6206. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  6207. }
  6208. result = RestClient.delete <span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&#x27;</span>,
  6209. <span class="hljs-symbol">params:</span> {
  6210. }, <span class="hljs-symbol">headers:</span> headers
  6211. p JSON.parse(result)
  6212. </code></pre>
  6213. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  6214. headers = {
  6215. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  6216. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  6217. }
  6218. r = requests.delete(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&#x27;</span>, headers = headers)
  6219. <span class="hljs-built_in">print</span>(r.json())
  6220. </code></pre>
  6221. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&quot;</span>);
  6222. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  6223. con.setRequestMethod(<span class="hljs-string">&quot;DELETE&quot;</span>);
  6224. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  6225. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  6226. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  6227. String inputLine;
  6228. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  6229. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  6230. response.append(inputLine);
  6231. }
  6232. in.close();
  6233. System.out.println(response.toString());
  6234. </code></pre>
  6235. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  6236. <span class="hljs-keyword">import</span> (
  6237. <span class="hljs-string">&quot;bytes&quot;</span>
  6238. <span class="hljs-string">&quot;net/http&quot;</span>
  6239. )
  6240. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  6241. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  6242. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  6243. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  6244. }
  6245. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  6246. req, err := http.NewRequest(<span class="hljs-string">&quot;DELETE&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&quot;</span>, data)
  6247. req.Header = headers
  6248. client := &amp;http.Client{}
  6249. resp, err := client.Do(req)
  6250. <span class="hljs-comment">// ...</span>
  6251. }
  6252. </code></pre>
  6253. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  6254. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  6255. );
  6256. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  6257. <span class="hljs-comment">// Define array of request body.</span>
  6258. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  6259. <span class="hljs-keyword">try</span> {
  6260. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;DELETE&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}&#x27;</span>, <span class="hljs-keyword">array</span>(
  6261. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  6262. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  6263. )
  6264. );
  6265. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  6266. }
  6267. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  6268. <span class="hljs-comment">// handle exception or api errors.</span>
  6269. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  6270. }
  6271. <span class="hljs-comment">// ...</span>
  6272. </code></pre>
  6273. <p><code>DELETE /api/boards/{board}/cards/{card}/checklists/{checklist}/items/{item}</code></p>
  6274. <p><em>Delete a checklist item</em></p>
  6275. <p>Note: this operation can't be reverted.</p>
  6276. <h3 id="delete_checklist_item-parameters">Parameters</h3>
  6277. <table>
  6278. <thead>
  6279. <tr>
  6280. <th>Name</th>
  6281. <th>In</th>
  6282. <th>Type</th>
  6283. <th>Required</th>
  6284. <th>Description</th>
  6285. </tr>
  6286. </thead>
  6287. <tbody>
  6288. <tr>
  6289. <td>board</td>
  6290. <td>path</td>
  6291. <td>string</td>
  6292. <td>true</td>
  6293. <td>the board ID</td>
  6294. </tr>
  6295. <tr>
  6296. <td>card</td>
  6297. <td>path</td>
  6298. <td>string</td>
  6299. <td>true</td>
  6300. <td>the card ID</td>
  6301. </tr>
  6302. <tr>
  6303. <td>checklist</td>
  6304. <td>path</td>
  6305. <td>string</td>
  6306. <td>true</td>
  6307. <td>the checklist ID</td>
  6308. </tr>
  6309. <tr>
  6310. <td>item</td>
  6311. <td>path</td>
  6312. <td>string</td>
  6313. <td>true</td>
  6314. <td>the ID of the item to be removed</td>
  6315. </tr>
  6316. </tbody>
  6317. </table>
  6318. <h4 id="detailed-descriptions-16">Detailed descriptions</h4>
  6319. <p><strong>board</strong>: the board ID</p>
  6320. <p><strong>card</strong>: the card ID</p>
  6321. <p><strong>checklist</strong>: the checklist ID</p>
  6322. <p><strong>item</strong>: the ID of the item to be removed</p>
  6323. <blockquote>
  6324. <p>Example responses</p>
  6325. </blockquote>
  6326. <blockquote>
  6327. <p>200 Response</p>
  6328. </blockquote>
  6329. <pre class="highlight tab tab-json"><code>{
  6330. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  6331. }
  6332. </code></pre>
  6333. <h3 id="delete_checklist_item-responses">Responses</h3>
  6334. <table>
  6335. <thead>
  6336. <tr>
  6337. <th>Status</th>
  6338. <th>Meaning</th>
  6339. <th>Description</th>
  6340. <th>Schema</th>
  6341. </tr>
  6342. </thead>
  6343. <tbody>
  6344. <tr>
  6345. <td>200</td>
  6346. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  6347. <td>200 response</td>
  6348. <td>Inline</td>
  6349. </tr>
  6350. </tbody>
  6351. </table>
  6352. <h3 id="delete_checklist_item-responseschema">Response Schema</h3>
  6353. <p>Status Code <strong>200</strong></p>
  6354. <table>
  6355. <thead>
  6356. <tr>
  6357. <th>Name</th>
  6358. <th>Type</th>
  6359. <th>Required</th>
  6360. <th>Restrictions</th>
  6361. <th>Description</th>
  6362. </tr>
  6363. </thead>
  6364. <tbody>
  6365. <tr>
  6366. <td>» _id</td>
  6367. <td>string</td>
  6368. <td>false</td>
  6369. <td>none</td>
  6370. <td>none</td>
  6371. </tr>
  6372. </tbody>
  6373. </table>
  6374. <aside class="warning">
  6375. To perform this operation, you must be authenticated by means of one of the following methods:
  6376. UserSecurity
  6377. </aside>
  6378. <h1 id="wekan-rest-api-cardcomments">CardComments</h1>
  6379. <h2 id="get_all_comments">get_all_comments</h2>
  6380. <p><a id="opIdget_all_comments"></a></p>
  6381. <blockquote>
  6382. <p>Code samples</p>
  6383. </blockquote>
  6384. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  6385. curl -X GET /api/boards/{board}/cards/{card}/comments \
  6386. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  6387. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  6388. </code></pre>
  6389. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/cards/{card}/comments</span> <span class="hljs-meta">HTTP/1.1</span>
  6390. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  6391. </span></code></pre>
  6392. <pre class="highlight tab tab-javascript"><code>
  6393. <span class="hljs-keyword">const</span> headers = {
  6394. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  6395. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  6396. };
  6397. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments&#x27;</span>,
  6398. {
  6399. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  6400. <span class="hljs-attr">headers</span>: headers
  6401. })
  6402. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  6403. <span class="hljs-keyword">return</span> res.json();
  6404. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  6405. <span class="hljs-built_in">console</span>.log(body);
  6406. });
  6407. </code></pre>
  6408. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  6409. <span class="hljs-keyword">const</span> headers = {
  6410. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  6411. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  6412. };
  6413. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments&#x27;</span>,
  6414. {
  6415. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  6416. <span class="hljs-attr">headers</span>: headers
  6417. })
  6418. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  6419. <span class="hljs-keyword">return</span> res.json();
  6420. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  6421. <span class="hljs-built_in">console</span>.log(body);
  6422. });
  6423. </code></pre>
  6424. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  6425. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  6426. headers = {
  6427. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  6428. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  6429. }
  6430. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments&#x27;</span>,
  6431. <span class="hljs-symbol">params:</span> {
  6432. }, <span class="hljs-symbol">headers:</span> headers
  6433. p JSON.parse(result)
  6434. </code></pre>
  6435. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  6436. headers = {
  6437. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  6438. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  6439. }
  6440. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments&#x27;</span>, headers = headers)
  6441. <span class="hljs-built_in">print</span>(r.json())
  6442. </code></pre>
  6443. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/comments&quot;</span>);
  6444. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  6445. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  6446. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  6447. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  6448. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  6449. String inputLine;
  6450. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  6451. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  6452. response.append(inputLine);
  6453. }
  6454. in.close();
  6455. System.out.println(response.toString());
  6456. </code></pre>
  6457. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  6458. <span class="hljs-keyword">import</span> (
  6459. <span class="hljs-string">&quot;bytes&quot;</span>
  6460. <span class="hljs-string">&quot;net/http&quot;</span>
  6461. )
  6462. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  6463. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  6464. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  6465. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  6466. }
  6467. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  6468. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/comments&quot;</span>, data)
  6469. req.Header = headers
  6470. client := &amp;http.Client{}
  6471. resp, err := client.Do(req)
  6472. <span class="hljs-comment">// ...</span>
  6473. }
  6474. </code></pre>
  6475. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  6476. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  6477. );
  6478. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  6479. <span class="hljs-comment">// Define array of request body.</span>
  6480. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  6481. <span class="hljs-keyword">try</span> {
  6482. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments&#x27;</span>, <span class="hljs-keyword">array</span>(
  6483. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  6484. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  6485. )
  6486. );
  6487. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  6488. }
  6489. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  6490. <span class="hljs-comment">// handle exception or api errors.</span>
  6491. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  6492. }
  6493. <span class="hljs-comment">// ...</span>
  6494. </code></pre>
  6495. <p><code>GET /api/boards/{board}/cards/{card}/comments</code></p>
  6496. <p><em>Get all comments attached to a card</em></p>
  6497. <h3 id="get_all_comments-parameters">Parameters</h3>
  6498. <table>
  6499. <thead>
  6500. <tr>
  6501. <th>Name</th>
  6502. <th>In</th>
  6503. <th>Type</th>
  6504. <th>Required</th>
  6505. <th>Description</th>
  6506. </tr>
  6507. </thead>
  6508. <tbody>
  6509. <tr>
  6510. <td>board</td>
  6511. <td>path</td>
  6512. <td>string</td>
  6513. <td>true</td>
  6514. <td>the board ID of the card</td>
  6515. </tr>
  6516. <tr>
  6517. <td>card</td>
  6518. <td>path</td>
  6519. <td>string</td>
  6520. <td>true</td>
  6521. <td>the ID of the card</td>
  6522. </tr>
  6523. </tbody>
  6524. </table>
  6525. <h4 id="detailed-descriptions-17">Detailed descriptions</h4>
  6526. <p><strong>board</strong>: the board ID of the card</p>
  6527. <p><strong>card</strong>: the ID of the card</p>
  6528. <blockquote>
  6529. <p>Example responses</p>
  6530. </blockquote>
  6531. <blockquote>
  6532. <p>200 Response</p>
  6533. </blockquote>
  6534. <pre class="highlight tab tab-json"><code>[
  6535. {
  6536. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  6537. <span class="hljs-attr">&quot;comment&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  6538. <span class="hljs-attr">&quot;authorId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  6539. }
  6540. ]
  6541. </code></pre>
  6542. <h3 id="get_all_comments-responses">Responses</h3>
  6543. <table>
  6544. <thead>
  6545. <tr>
  6546. <th>Status</th>
  6547. <th>Meaning</th>
  6548. <th>Description</th>
  6549. <th>Schema</th>
  6550. </tr>
  6551. </thead>
  6552. <tbody>
  6553. <tr>
  6554. <td>200</td>
  6555. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  6556. <td>200 response</td>
  6557. <td>Inline</td>
  6558. </tr>
  6559. </tbody>
  6560. </table>
  6561. <h3 id="get_all_comments-responseschema">Response Schema</h3>
  6562. <p>Status Code <strong>200</strong></p>
  6563. <table>
  6564. <thead>
  6565. <tr>
  6566. <th>Name</th>
  6567. <th>Type</th>
  6568. <th>Required</th>
  6569. <th>Restrictions</th>
  6570. <th>Description</th>
  6571. </tr>
  6572. </thead>
  6573. <tbody>
  6574. <tr>
  6575. <td>» _id</td>
  6576. <td>string</td>
  6577. <td>false</td>
  6578. <td>none</td>
  6579. <td>none</td>
  6580. </tr>
  6581. <tr>
  6582. <td>» comment</td>
  6583. <td>string</td>
  6584. <td>false</td>
  6585. <td>none</td>
  6586. <td>none</td>
  6587. </tr>
  6588. <tr>
  6589. <td>» authorId</td>
  6590. <td>string</td>
  6591. <td>false</td>
  6592. <td>none</td>
  6593. <td>none</td>
  6594. </tr>
  6595. </tbody>
  6596. </table>
  6597. <aside class="warning">
  6598. To perform this operation, you must be authenticated by means of one of the following methods:
  6599. UserSecurity
  6600. </aside>
  6601. <h2 id="new_comment">new_comment</h2>
  6602. <p><a id="opIdnew_comment"></a></p>
  6603. <blockquote>
  6604. <p>Code samples</p>
  6605. </blockquote>
  6606. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  6607. curl -X POST /api/boards/{board}/cards/{card}/comments \
  6608. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  6609. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  6610. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  6611. </code></pre>
  6612. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/boards/{board}/cards/{card}/comments</span> <span class="hljs-meta">HTTP/1.1</span>
  6613. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  6614. Accept: application/json
  6615. </span></code></pre>
  6616. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  6617. &quot;authorId&quot;: &quot;string&quot;,
  6618. &quot;comment&quot;: &quot;string&quot;
  6619. }&#x27;</span>;
  6620. <span class="hljs-keyword">const</span> headers = {
  6621. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  6622. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  6623. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  6624. };
  6625. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments&#x27;</span>,
  6626. {
  6627. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  6628. <span class="hljs-attr">body</span>: inputBody,
  6629. <span class="hljs-attr">headers</span>: headers
  6630. })
  6631. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  6632. <span class="hljs-keyword">return</span> res.json();
  6633. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  6634. <span class="hljs-built_in">console</span>.log(body);
  6635. });
  6636. </code></pre>
  6637. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  6638. <span class="hljs-keyword">const</span> inputBody = {
  6639. <span class="hljs-string">&quot;authorId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  6640. <span class="hljs-string">&quot;comment&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  6641. };
  6642. <span class="hljs-keyword">const</span> headers = {
  6643. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  6644. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  6645. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  6646. };
  6647. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments&#x27;</span>,
  6648. {
  6649. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  6650. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  6651. <span class="hljs-attr">headers</span>: headers
  6652. })
  6653. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  6654. <span class="hljs-keyword">return</span> res.json();
  6655. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  6656. <span class="hljs-built_in">console</span>.log(body);
  6657. });
  6658. </code></pre>
  6659. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  6660. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  6661. headers = {
  6662. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  6663. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  6664. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  6665. }
  6666. result = RestClient.post <span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments&#x27;</span>,
  6667. <span class="hljs-symbol">params:</span> {
  6668. }, <span class="hljs-symbol">headers:</span> headers
  6669. p JSON.parse(result)
  6670. </code></pre>
  6671. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  6672. headers = {
  6673. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  6674. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  6675. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  6676. }
  6677. r = requests.post(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments&#x27;</span>, headers = headers)
  6678. <span class="hljs-built_in">print</span>(r.json())
  6679. </code></pre>
  6680. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/comments&quot;</span>);
  6681. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  6682. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  6683. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  6684. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  6685. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  6686. String inputLine;
  6687. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  6688. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  6689. response.append(inputLine);
  6690. }
  6691. in.close();
  6692. System.out.println(response.toString());
  6693. </code></pre>
  6694. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  6695. <span class="hljs-keyword">import</span> (
  6696. <span class="hljs-string">&quot;bytes&quot;</span>
  6697. <span class="hljs-string">&quot;net/http&quot;</span>
  6698. )
  6699. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  6700. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  6701. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  6702. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  6703. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  6704. }
  6705. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  6706. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/comments&quot;</span>, data)
  6707. req.Header = headers
  6708. client := &amp;http.Client{}
  6709. resp, err := client.Do(req)
  6710. <span class="hljs-comment">// ...</span>
  6711. }
  6712. </code></pre>
  6713. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  6714. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  6715. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  6716. );
  6717. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  6718. <span class="hljs-comment">// Define array of request body.</span>
  6719. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  6720. <span class="hljs-keyword">try</span> {
  6721. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments&#x27;</span>, <span class="hljs-keyword">array</span>(
  6722. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  6723. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  6724. )
  6725. );
  6726. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  6727. }
  6728. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  6729. <span class="hljs-comment">// handle exception or api errors.</span>
  6730. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  6731. }
  6732. <span class="hljs-comment">// ...</span>
  6733. </code></pre>
  6734. <p><code>POST /api/boards/{board}/cards/{card}/comments</code></p>
  6735. <p><em>Add a comment on a card</em></p>
  6736. <blockquote>
  6737. <p>Body parameter</p>
  6738. </blockquote>
  6739. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">authorId:</span> <span class="hljs-string">string</span>
  6740. <span class="hljs-attr">comment:</span> <span class="hljs-string">string</span>
  6741. </code></pre>
  6742. <h3 id="new_comment-parameters">Parameters</h3>
  6743. <table>
  6744. <thead>
  6745. <tr>
  6746. <th>Name</th>
  6747. <th>In</th>
  6748. <th>Type</th>
  6749. <th>Required</th>
  6750. <th>Description</th>
  6751. </tr>
  6752. </thead>
  6753. <tbody>
  6754. <tr>
  6755. <td>board</td>
  6756. <td>path</td>
  6757. <td>string</td>
  6758. <td>true</td>
  6759. <td>the board ID of the card</td>
  6760. </tr>
  6761. <tr>
  6762. <td>card</td>
  6763. <td>path</td>
  6764. <td>string</td>
  6765. <td>true</td>
  6766. <td>the ID of the card</td>
  6767. </tr>
  6768. <tr>
  6769. <td>body</td>
  6770. <td>body</td>
  6771. <td>object</td>
  6772. <td>true</td>
  6773. <td>none</td>
  6774. </tr>
  6775. <tr>
  6776. <td>» authorId</td>
  6777. <td>body</td>
  6778. <td>string</td>
  6779. <td>true</td>
  6780. <td>the user who 'posted' the comment</td>
  6781. </tr>
  6782. <tr>
  6783. <td>» comment</td>
  6784. <td>body</td>
  6785. <td>string</td>
  6786. <td>true</td>
  6787. <td>the comment value</td>
  6788. </tr>
  6789. </tbody>
  6790. </table>
  6791. <h4 id="detailed-descriptions-18">Detailed descriptions</h4>
  6792. <p><strong>board</strong>: the board ID of the card</p>
  6793. <p><strong>card</strong>: the ID of the card</p>
  6794. <blockquote>
  6795. <p>Example responses</p>
  6796. </blockquote>
  6797. <blockquote>
  6798. <p>200 Response</p>
  6799. </blockquote>
  6800. <pre class="highlight tab tab-json"><code>{
  6801. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  6802. }
  6803. </code></pre>
  6804. <h3 id="new_comment-responses">Responses</h3>
  6805. <table>
  6806. <thead>
  6807. <tr>
  6808. <th>Status</th>
  6809. <th>Meaning</th>
  6810. <th>Description</th>
  6811. <th>Schema</th>
  6812. </tr>
  6813. </thead>
  6814. <tbody>
  6815. <tr>
  6816. <td>200</td>
  6817. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  6818. <td>200 response</td>
  6819. <td>Inline</td>
  6820. </tr>
  6821. </tbody>
  6822. </table>
  6823. <h3 id="new_comment-responseschema">Response Schema</h3>
  6824. <p>Status Code <strong>200</strong></p>
  6825. <table>
  6826. <thead>
  6827. <tr>
  6828. <th>Name</th>
  6829. <th>Type</th>
  6830. <th>Required</th>
  6831. <th>Restrictions</th>
  6832. <th>Description</th>
  6833. </tr>
  6834. </thead>
  6835. <tbody>
  6836. <tr>
  6837. <td>» _id</td>
  6838. <td>string</td>
  6839. <td>false</td>
  6840. <td>none</td>
  6841. <td>none</td>
  6842. </tr>
  6843. </tbody>
  6844. </table>
  6845. <aside class="warning">
  6846. To perform this operation, you must be authenticated by means of one of the following methods:
  6847. UserSecurity
  6848. </aside>
  6849. <h2 id="get_comment">get_comment</h2>
  6850. <p><a id="opIdget_comment"></a></p>
  6851. <blockquote>
  6852. <p>Code samples</p>
  6853. </blockquote>
  6854. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  6855. curl -X GET /api/boards/{board}/cards/{card}/comments/{comment} \
  6856. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  6857. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  6858. </code></pre>
  6859. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/cards/{card}/comments/{comment}</span> <span class="hljs-meta">HTTP/1.1</span>
  6860. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  6861. </span></code></pre>
  6862. <pre class="highlight tab tab-javascript"><code>
  6863. <span class="hljs-keyword">const</span> headers = {
  6864. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  6865. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  6866. };
  6867. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments/{comment}&#x27;</span>,
  6868. {
  6869. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  6870. <span class="hljs-attr">headers</span>: headers
  6871. })
  6872. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  6873. <span class="hljs-keyword">return</span> res.json();
  6874. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  6875. <span class="hljs-built_in">console</span>.log(body);
  6876. });
  6877. </code></pre>
  6878. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  6879. <span class="hljs-keyword">const</span> headers = {
  6880. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  6881. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  6882. };
  6883. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments/{comment}&#x27;</span>,
  6884. {
  6885. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  6886. <span class="hljs-attr">headers</span>: headers
  6887. })
  6888. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  6889. <span class="hljs-keyword">return</span> res.json();
  6890. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  6891. <span class="hljs-built_in">console</span>.log(body);
  6892. });
  6893. </code></pre>
  6894. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  6895. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  6896. headers = {
  6897. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  6898. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  6899. }
  6900. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments/{comment}&#x27;</span>,
  6901. <span class="hljs-symbol">params:</span> {
  6902. }, <span class="hljs-symbol">headers:</span> headers
  6903. p JSON.parse(result)
  6904. </code></pre>
  6905. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  6906. headers = {
  6907. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  6908. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  6909. }
  6910. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments/{comment}&#x27;</span>, headers = headers)
  6911. <span class="hljs-built_in">print</span>(r.json())
  6912. </code></pre>
  6913. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/comments/{comment}&quot;</span>);
  6914. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  6915. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  6916. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  6917. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  6918. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  6919. String inputLine;
  6920. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  6921. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  6922. response.append(inputLine);
  6923. }
  6924. in.close();
  6925. System.out.println(response.toString());
  6926. </code></pre>
  6927. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  6928. <span class="hljs-keyword">import</span> (
  6929. <span class="hljs-string">&quot;bytes&quot;</span>
  6930. <span class="hljs-string">&quot;net/http&quot;</span>
  6931. )
  6932. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  6933. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  6934. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  6935. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  6936. }
  6937. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  6938. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/comments/{comment}&quot;</span>, data)
  6939. req.Header = headers
  6940. client := &amp;http.Client{}
  6941. resp, err := client.Do(req)
  6942. <span class="hljs-comment">// ...</span>
  6943. }
  6944. </code></pre>
  6945. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  6946. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  6947. );
  6948. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  6949. <span class="hljs-comment">// Define array of request body.</span>
  6950. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  6951. <span class="hljs-keyword">try</span> {
  6952. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments/{comment}&#x27;</span>, <span class="hljs-keyword">array</span>(
  6953. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  6954. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  6955. )
  6956. );
  6957. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  6958. }
  6959. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  6960. <span class="hljs-comment">// handle exception or api errors.</span>
  6961. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  6962. }
  6963. <span class="hljs-comment">// ...</span>
  6964. </code></pre>
  6965. <p><code>GET /api/boards/{board}/cards/{card}/comments/{comment}</code></p>
  6966. <p><em>Get a comment on a card</em></p>
  6967. <h3 id="get_comment-parameters">Parameters</h3>
  6968. <table>
  6969. <thead>
  6970. <tr>
  6971. <th>Name</th>
  6972. <th>In</th>
  6973. <th>Type</th>
  6974. <th>Required</th>
  6975. <th>Description</th>
  6976. </tr>
  6977. </thead>
  6978. <tbody>
  6979. <tr>
  6980. <td>board</td>
  6981. <td>path</td>
  6982. <td>string</td>
  6983. <td>true</td>
  6984. <td>the board ID of the card</td>
  6985. </tr>
  6986. <tr>
  6987. <td>card</td>
  6988. <td>path</td>
  6989. <td>string</td>
  6990. <td>true</td>
  6991. <td>the ID of the card</td>
  6992. </tr>
  6993. <tr>
  6994. <td>comment</td>
  6995. <td>path</td>
  6996. <td>string</td>
  6997. <td>true</td>
  6998. <td>the ID of the comment to retrieve</td>
  6999. </tr>
  7000. </tbody>
  7001. </table>
  7002. <h4 id="detailed-descriptions-19">Detailed descriptions</h4>
  7003. <p><strong>board</strong>: the board ID of the card</p>
  7004. <p><strong>card</strong>: the ID of the card</p>
  7005. <p><strong>comment</strong>: the ID of the comment to retrieve</p>
  7006. <blockquote>
  7007. <p>Example responses</p>
  7008. </blockquote>
  7009. <blockquote>
  7010. <p>200 Response</p>
  7011. </blockquote>
  7012. <pre class="highlight tab tab-json"><code>{
  7013. <span class="hljs-attr">&quot;boardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  7014. <span class="hljs-attr">&quot;cardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  7015. <span class="hljs-attr">&quot;text&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  7016. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  7017. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  7018. <span class="hljs-attr">&quot;userId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  7019. }
  7020. </code></pre>
  7021. <h3 id="get_comment-responses">Responses</h3>
  7022. <table>
  7023. <thead>
  7024. <tr>
  7025. <th>Status</th>
  7026. <th>Meaning</th>
  7027. <th>Description</th>
  7028. <th>Schema</th>
  7029. </tr>
  7030. </thead>
  7031. <tbody>
  7032. <tr>
  7033. <td>200</td>
  7034. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  7035. <td>200 response</td>
  7036. <td><a href="#schemacardcomments">CardComments</a></td>
  7037. </tr>
  7038. </tbody>
  7039. </table>
  7040. <aside class="warning">
  7041. To perform this operation, you must be authenticated by means of one of the following methods:
  7042. UserSecurity
  7043. </aside>
  7044. <h2 id="delete_comment">delete_comment</h2>
  7045. <p><a id="opIddelete_comment"></a></p>
  7046. <blockquote>
  7047. <p>Code samples</p>
  7048. </blockquote>
  7049. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  7050. curl -X DELETE /api/boards/{board}/cards/{card}/comments/{comment} \
  7051. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  7052. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  7053. </code></pre>
  7054. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">DELETE</span> <span class="hljs-string">/api/boards/{board}/cards/{card}/comments/{comment}</span> <span class="hljs-meta">HTTP/1.1</span>
  7055. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  7056. </span></code></pre>
  7057. <pre class="highlight tab tab-javascript"><code>
  7058. <span class="hljs-keyword">const</span> headers = {
  7059. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  7060. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7061. };
  7062. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments/{comment}&#x27;</span>,
  7063. {
  7064. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  7065. <span class="hljs-attr">headers</span>: headers
  7066. })
  7067. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  7068. <span class="hljs-keyword">return</span> res.json();
  7069. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  7070. <span class="hljs-built_in">console</span>.log(body);
  7071. });
  7072. </code></pre>
  7073. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  7074. <span class="hljs-keyword">const</span> headers = {
  7075. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  7076. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7077. };
  7078. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments/{comment}&#x27;</span>,
  7079. {
  7080. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  7081. <span class="hljs-attr">headers</span>: headers
  7082. })
  7083. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  7084. <span class="hljs-keyword">return</span> res.json();
  7085. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  7086. <span class="hljs-built_in">console</span>.log(body);
  7087. });
  7088. </code></pre>
  7089. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  7090. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  7091. headers = {
  7092. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  7093. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7094. }
  7095. result = RestClient.delete <span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments/{comment}&#x27;</span>,
  7096. <span class="hljs-symbol">params:</span> {
  7097. }, <span class="hljs-symbol">headers:</span> headers
  7098. p JSON.parse(result)
  7099. </code></pre>
  7100. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  7101. headers = {
  7102. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  7103. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7104. }
  7105. r = requests.delete(<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments/{comment}&#x27;</span>, headers = headers)
  7106. <span class="hljs-built_in">print</span>(r.json())
  7107. </code></pre>
  7108. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/comments/{comment}&quot;</span>);
  7109. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  7110. con.setRequestMethod(<span class="hljs-string">&quot;DELETE&quot;</span>);
  7111. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  7112. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  7113. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  7114. String inputLine;
  7115. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  7116. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  7117. response.append(inputLine);
  7118. }
  7119. in.close();
  7120. System.out.println(response.toString());
  7121. </code></pre>
  7122. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  7123. <span class="hljs-keyword">import</span> (
  7124. <span class="hljs-string">&quot;bytes&quot;</span>
  7125. <span class="hljs-string">&quot;net/http&quot;</span>
  7126. )
  7127. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  7128. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  7129. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  7130. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  7131. }
  7132. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  7133. req, err := http.NewRequest(<span class="hljs-string">&quot;DELETE&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/cards/{card}/comments/{comment}&quot;</span>, data)
  7134. req.Header = headers
  7135. client := &amp;http.Client{}
  7136. resp, err := client.Do(req)
  7137. <span class="hljs-comment">// ...</span>
  7138. }
  7139. </code></pre>
  7140. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  7141. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  7142. );
  7143. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  7144. <span class="hljs-comment">// Define array of request body.</span>
  7145. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  7146. <span class="hljs-keyword">try</span> {
  7147. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;DELETE&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/cards/{card}/comments/{comment}&#x27;</span>, <span class="hljs-keyword">array</span>(
  7148. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  7149. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  7150. )
  7151. );
  7152. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  7153. }
  7154. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  7155. <span class="hljs-comment">// handle exception or api errors.</span>
  7156. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  7157. }
  7158. <span class="hljs-comment">// ...</span>
  7159. </code></pre>
  7160. <p><code>DELETE /api/boards/{board}/cards/{card}/comments/{comment}</code></p>
  7161. <p><em>Delete a comment on a card</em></p>
  7162. <h3 id="delete_comment-parameters">Parameters</h3>
  7163. <table>
  7164. <thead>
  7165. <tr>
  7166. <th>Name</th>
  7167. <th>In</th>
  7168. <th>Type</th>
  7169. <th>Required</th>
  7170. <th>Description</th>
  7171. </tr>
  7172. </thead>
  7173. <tbody>
  7174. <tr>
  7175. <td>board</td>
  7176. <td>path</td>
  7177. <td>string</td>
  7178. <td>true</td>
  7179. <td>the board ID of the card</td>
  7180. </tr>
  7181. <tr>
  7182. <td>card</td>
  7183. <td>path</td>
  7184. <td>string</td>
  7185. <td>true</td>
  7186. <td>the ID of the card</td>
  7187. </tr>
  7188. <tr>
  7189. <td>comment</td>
  7190. <td>path</td>
  7191. <td>string</td>
  7192. <td>true</td>
  7193. <td>the ID of the comment to delete</td>
  7194. </tr>
  7195. </tbody>
  7196. </table>
  7197. <h4 id="detailed-descriptions-20">Detailed descriptions</h4>
  7198. <p><strong>board</strong>: the board ID of the card</p>
  7199. <p><strong>card</strong>: the ID of the card</p>
  7200. <p><strong>comment</strong>: the ID of the comment to delete</p>
  7201. <blockquote>
  7202. <p>Example responses</p>
  7203. </blockquote>
  7204. <blockquote>
  7205. <p>200 Response</p>
  7206. </blockquote>
  7207. <pre class="highlight tab tab-json"><code>{
  7208. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  7209. }
  7210. </code></pre>
  7211. <h3 id="delete_comment-responses">Responses</h3>
  7212. <table>
  7213. <thead>
  7214. <tr>
  7215. <th>Status</th>
  7216. <th>Meaning</th>
  7217. <th>Description</th>
  7218. <th>Schema</th>
  7219. </tr>
  7220. </thead>
  7221. <tbody>
  7222. <tr>
  7223. <td>200</td>
  7224. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  7225. <td>200 response</td>
  7226. <td>Inline</td>
  7227. </tr>
  7228. </tbody>
  7229. </table>
  7230. <h3 id="delete_comment-responseschema">Response Schema</h3>
  7231. <p>Status Code <strong>200</strong></p>
  7232. <table>
  7233. <thead>
  7234. <tr>
  7235. <th>Name</th>
  7236. <th>Type</th>
  7237. <th>Required</th>
  7238. <th>Restrictions</th>
  7239. <th>Description</th>
  7240. </tr>
  7241. </thead>
  7242. <tbody>
  7243. <tr>
  7244. <td>» _id</td>
  7245. <td>string</td>
  7246. <td>false</td>
  7247. <td>none</td>
  7248. <td>none</td>
  7249. </tr>
  7250. </tbody>
  7251. </table>
  7252. <aside class="warning">
  7253. To perform this operation, you must be authenticated by means of one of the following methods:
  7254. UserSecurity
  7255. </aside>
  7256. <h1 id="wekan-rest-api-cards">Cards</h1>
  7257. <h2 id="get_cards_by_custom_field">get_cards_by_custom_field</h2>
  7258. <p><a id="opIdget_cards_by_custom_field"></a></p>
  7259. <blockquote>
  7260. <p>Code samples</p>
  7261. </blockquote>
  7262. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  7263. curl -X GET /api/boards/{board}/cardsByCustomField/{customField}/{customFieldValue} \
  7264. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  7265. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  7266. </code></pre>
  7267. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/cardsByCustomField/{customField}/{customFieldValue}</span> <span class="hljs-meta">HTTP/1.1</span>
  7268. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  7269. </span></code></pre>
  7270. <pre class="highlight tab tab-javascript"><code>
  7271. <span class="hljs-keyword">const</span> headers = {
  7272. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  7273. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7274. };
  7275. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cardsByCustomField/{customField}/{customFieldValue}&#x27;</span>,
  7276. {
  7277. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  7278. <span class="hljs-attr">headers</span>: headers
  7279. })
  7280. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  7281. <span class="hljs-keyword">return</span> res.json();
  7282. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  7283. <span class="hljs-built_in">console</span>.log(body);
  7284. });
  7285. </code></pre>
  7286. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  7287. <span class="hljs-keyword">const</span> headers = {
  7288. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  7289. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7290. };
  7291. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cardsByCustomField/{customField}/{customFieldValue}&#x27;</span>,
  7292. {
  7293. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  7294. <span class="hljs-attr">headers</span>: headers
  7295. })
  7296. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  7297. <span class="hljs-keyword">return</span> res.json();
  7298. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  7299. <span class="hljs-built_in">console</span>.log(body);
  7300. });
  7301. </code></pre>
  7302. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  7303. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  7304. headers = {
  7305. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  7306. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7307. }
  7308. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/cardsByCustomField/{customField}/{customFieldValue}&#x27;</span>,
  7309. <span class="hljs-symbol">params:</span> {
  7310. }, <span class="hljs-symbol">headers:</span> headers
  7311. p JSON.parse(result)
  7312. </code></pre>
  7313. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  7314. headers = {
  7315. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  7316. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7317. }
  7318. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/cardsByCustomField/{customField}/{customFieldValue}&#x27;</span>, headers = headers)
  7319. <span class="hljs-built_in">print</span>(r.json())
  7320. </code></pre>
  7321. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/cardsByCustomField/{customField}/{customFieldValue}&quot;</span>);
  7322. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  7323. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  7324. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  7325. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  7326. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  7327. String inputLine;
  7328. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  7329. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  7330. response.append(inputLine);
  7331. }
  7332. in.close();
  7333. System.out.println(response.toString());
  7334. </code></pre>
  7335. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  7336. <span class="hljs-keyword">import</span> (
  7337. <span class="hljs-string">&quot;bytes&quot;</span>
  7338. <span class="hljs-string">&quot;net/http&quot;</span>
  7339. )
  7340. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  7341. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  7342. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  7343. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  7344. }
  7345. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  7346. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/cardsByCustomField/{customField}/{customFieldValue}&quot;</span>, data)
  7347. req.Header = headers
  7348. client := &amp;http.Client{}
  7349. resp, err := client.Do(req)
  7350. <span class="hljs-comment">// ...</span>
  7351. }
  7352. </code></pre>
  7353. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  7354. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  7355. );
  7356. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  7357. <span class="hljs-comment">// Define array of request body.</span>
  7358. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  7359. <span class="hljs-keyword">try</span> {
  7360. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/cardsByCustomField/{customField}/{customFieldValue}&#x27;</span>, <span class="hljs-keyword">array</span>(
  7361. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  7362. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  7363. )
  7364. );
  7365. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  7366. }
  7367. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  7368. <span class="hljs-comment">// handle exception or api errors.</span>
  7369. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  7370. }
  7371. <span class="hljs-comment">// ...</span>
  7372. </code></pre>
  7373. <p><code>GET /api/boards/{board}/cardsByCustomField/{customField}/{customFieldValue}</code></p>
  7374. <p><em>Get all Cards that matchs a value of a specific custom field</em></p>
  7375. <h3 id="get_cards_by_custom_field-parameters">Parameters</h3>
  7376. <table>
  7377. <thead>
  7378. <tr>
  7379. <th>Name</th>
  7380. <th>In</th>
  7381. <th>Type</th>
  7382. <th>Required</th>
  7383. <th>Description</th>
  7384. </tr>
  7385. </thead>
  7386. <tbody>
  7387. <tr>
  7388. <td>board</td>
  7389. <td>path</td>
  7390. <td>string</td>
  7391. <td>true</td>
  7392. <td>the board ID</td>
  7393. </tr>
  7394. <tr>
  7395. <td>customField</td>
  7396. <td>path</td>
  7397. <td>string</td>
  7398. <td>true</td>
  7399. <td>the list ID</td>
  7400. </tr>
  7401. <tr>
  7402. <td>customFieldValue</td>
  7403. <td>path</td>
  7404. <td>string</td>
  7405. <td>true</td>
  7406. <td>the value to look for</td>
  7407. </tr>
  7408. </tbody>
  7409. </table>
  7410. <h4 id="detailed-descriptions-21">Detailed descriptions</h4>
  7411. <p><strong>board</strong>: the board ID</p>
  7412. <p><strong>customField</strong>: the list ID</p>
  7413. <p><strong>customFieldValue</strong>: the value to look for</p>
  7414. <blockquote>
  7415. <p>Example responses</p>
  7416. </blockquote>
  7417. <blockquote>
  7418. <p>200 Response</p>
  7419. </blockquote>
  7420. <pre class="highlight tab tab-json"><code>[
  7421. {
  7422. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  7423. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  7424. <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  7425. <span class="hljs-attr">&quot;listId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  7426. <span class="hljs-attr">&quot;swinlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  7427. }
  7428. ]
  7429. </code></pre>
  7430. <h3 id="get_cards_by_custom_field-responses">Responses</h3>
  7431. <table>
  7432. <thead>
  7433. <tr>
  7434. <th>Status</th>
  7435. <th>Meaning</th>
  7436. <th>Description</th>
  7437. <th>Schema</th>
  7438. </tr>
  7439. </thead>
  7440. <tbody>
  7441. <tr>
  7442. <td>200</td>
  7443. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  7444. <td>200 response</td>
  7445. <td>Inline</td>
  7446. </tr>
  7447. </tbody>
  7448. </table>
  7449. <h3 id="get_cards_by_custom_field-responseschema">Response Schema</h3>
  7450. <p>Status Code <strong>200</strong></p>
  7451. <table>
  7452. <thead>
  7453. <tr>
  7454. <th>Name</th>
  7455. <th>Type</th>
  7456. <th>Required</th>
  7457. <th>Restrictions</th>
  7458. <th>Description</th>
  7459. </tr>
  7460. </thead>
  7461. <tbody>
  7462. <tr>
  7463. <td>» _id</td>
  7464. <td>string</td>
  7465. <td>false</td>
  7466. <td>none</td>
  7467. <td>none</td>
  7468. </tr>
  7469. <tr>
  7470. <td>» title</td>
  7471. <td>string</td>
  7472. <td>false</td>
  7473. <td>none</td>
  7474. <td>none</td>
  7475. </tr>
  7476. <tr>
  7477. <td>» description</td>
  7478. <td>string</td>
  7479. <td>false</td>
  7480. <td>none</td>
  7481. <td>none</td>
  7482. </tr>
  7483. <tr>
  7484. <td>» listId</td>
  7485. <td>string</td>
  7486. <td>false</td>
  7487. <td>none</td>
  7488. <td>none</td>
  7489. </tr>
  7490. <tr>
  7491. <td>» swinlaneId</td>
  7492. <td>string</td>
  7493. <td>false</td>
  7494. <td>none</td>
  7495. <td>none</td>
  7496. </tr>
  7497. </tbody>
  7498. </table>
  7499. <aside class="warning">
  7500. To perform this operation, you must be authenticated by means of one of the following methods:
  7501. UserSecurity
  7502. </aside>
  7503. <h2 id="get_board_cards_count">get_board_cards_count</h2>
  7504. <p><a id="opIdget_board_cards_count"></a></p>
  7505. <blockquote>
  7506. <p>Code samples</p>
  7507. </blockquote>
  7508. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  7509. curl -X GET /api/boards/{board}/cards_count \
  7510. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  7511. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  7512. </code></pre>
  7513. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/cards_count</span> <span class="hljs-meta">HTTP/1.1</span>
  7514. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  7515. </span></code></pre>
  7516. <pre class="highlight tab tab-javascript"><code>
  7517. <span class="hljs-keyword">const</span> headers = {
  7518. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  7519. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7520. };
  7521. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards_count&#x27;</span>,
  7522. {
  7523. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  7524. <span class="hljs-attr">headers</span>: headers
  7525. })
  7526. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  7527. <span class="hljs-keyword">return</span> res.json();
  7528. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  7529. <span class="hljs-built_in">console</span>.log(body);
  7530. });
  7531. </code></pre>
  7532. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  7533. <span class="hljs-keyword">const</span> headers = {
  7534. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  7535. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7536. };
  7537. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/cards_count&#x27;</span>,
  7538. {
  7539. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  7540. <span class="hljs-attr">headers</span>: headers
  7541. })
  7542. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  7543. <span class="hljs-keyword">return</span> res.json();
  7544. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  7545. <span class="hljs-built_in">console</span>.log(body);
  7546. });
  7547. </code></pre>
  7548. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  7549. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  7550. headers = {
  7551. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  7552. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7553. }
  7554. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/cards_count&#x27;</span>,
  7555. <span class="hljs-symbol">params:</span> {
  7556. }, <span class="hljs-symbol">headers:</span> headers
  7557. p JSON.parse(result)
  7558. </code></pre>
  7559. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  7560. headers = {
  7561. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  7562. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7563. }
  7564. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/cards_count&#x27;</span>, headers = headers)
  7565. <span class="hljs-built_in">print</span>(r.json())
  7566. </code></pre>
  7567. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/cards_count&quot;</span>);
  7568. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  7569. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  7570. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  7571. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  7572. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  7573. String inputLine;
  7574. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  7575. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  7576. response.append(inputLine);
  7577. }
  7578. in.close();
  7579. System.out.println(response.toString());
  7580. </code></pre>
  7581. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  7582. <span class="hljs-keyword">import</span> (
  7583. <span class="hljs-string">&quot;bytes&quot;</span>
  7584. <span class="hljs-string">&quot;net/http&quot;</span>
  7585. )
  7586. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  7587. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  7588. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  7589. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  7590. }
  7591. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  7592. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/cards_count&quot;</span>, data)
  7593. req.Header = headers
  7594. client := &amp;http.Client{}
  7595. resp, err := client.Do(req)
  7596. <span class="hljs-comment">// ...</span>
  7597. }
  7598. </code></pre>
  7599. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  7600. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  7601. );
  7602. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  7603. <span class="hljs-comment">// Define array of request body.</span>
  7604. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  7605. <span class="hljs-keyword">try</span> {
  7606. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/cards_count&#x27;</span>, <span class="hljs-keyword">array</span>(
  7607. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  7608. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  7609. )
  7610. );
  7611. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  7612. }
  7613. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  7614. <span class="hljs-comment">// handle exception or api errors.</span>
  7615. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  7616. }
  7617. <span class="hljs-comment">// ...</span>
  7618. </code></pre>
  7619. <p><code>GET /api/boards/{board}/cards_count</code></p>
  7620. <p><em>Get a cards count to a board</em></p>
  7621. <h3 id="get_board_cards_count-parameters">Parameters</h3>
  7622. <table>
  7623. <thead>
  7624. <tr>
  7625. <th>Name</th>
  7626. <th>In</th>
  7627. <th>Type</th>
  7628. <th>Required</th>
  7629. <th>Description</th>
  7630. </tr>
  7631. </thead>
  7632. <tbody>
  7633. <tr>
  7634. <td>board</td>
  7635. <td>path</td>
  7636. <td>string</td>
  7637. <td>true</td>
  7638. <td>the board ID</td>
  7639. </tr>
  7640. </tbody>
  7641. </table>
  7642. <h4 id="detailed-descriptions-22">Detailed descriptions</h4>
  7643. <p><strong>board</strong>: the board ID</p>
  7644. <blockquote>
  7645. <p>Example responses</p>
  7646. </blockquote>
  7647. <blockquote>
  7648. <p>200 Response</p>
  7649. </blockquote>
  7650. <pre class="highlight tab tab-json"><code>{
  7651. <span class="hljs-attr">&quot;board_cards_count&quot;</span>: <span class="hljs-number">0</span>
  7652. }
  7653. </code></pre>
  7654. <h3 id="get_board_cards_count-responses">Responses</h3>
  7655. <table>
  7656. <thead>
  7657. <tr>
  7658. <th>Status</th>
  7659. <th>Meaning</th>
  7660. <th>Description</th>
  7661. <th>Schema</th>
  7662. </tr>
  7663. </thead>
  7664. <tbody>
  7665. <tr>
  7666. <td>200</td>
  7667. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  7668. <td>200 response</td>
  7669. <td>Inline</td>
  7670. </tr>
  7671. </tbody>
  7672. </table>
  7673. <h3 id="get_board_cards_count-responseschema">Response Schema</h3>
  7674. <p>Status Code <strong>200</strong></p>
  7675. <table>
  7676. <thead>
  7677. <tr>
  7678. <th>Name</th>
  7679. <th>Type</th>
  7680. <th>Required</th>
  7681. <th>Restrictions</th>
  7682. <th>Description</th>
  7683. </tr>
  7684. </thead>
  7685. <tbody>
  7686. <tr>
  7687. <td>» board_cards_count</td>
  7688. <td>integer</td>
  7689. <td>false</td>
  7690. <td>none</td>
  7691. <td>none</td>
  7692. </tr>
  7693. </tbody>
  7694. </table>
  7695. <aside class="warning">
  7696. To perform this operation, you must be authenticated by means of one of the following methods:
  7697. UserSecurity
  7698. </aside>
  7699. <h2 id="get_all_cards">get_all_cards</h2>
  7700. <p><a id="opIdget_all_cards"></a></p>
  7701. <blockquote>
  7702. <p>Code samples</p>
  7703. </blockquote>
  7704. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  7705. curl -X GET /api/boards/{board}/lists/{list}/cards \
  7706. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  7707. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  7708. </code></pre>
  7709. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/lists/{list}/cards</span> <span class="hljs-meta">HTTP/1.1</span>
  7710. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  7711. </span></code></pre>
  7712. <pre class="highlight tab tab-javascript"><code>
  7713. <span class="hljs-keyword">const</span> headers = {
  7714. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  7715. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7716. };
  7717. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards&#x27;</span>,
  7718. {
  7719. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  7720. <span class="hljs-attr">headers</span>: headers
  7721. })
  7722. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  7723. <span class="hljs-keyword">return</span> res.json();
  7724. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  7725. <span class="hljs-built_in">console</span>.log(body);
  7726. });
  7727. </code></pre>
  7728. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  7729. <span class="hljs-keyword">const</span> headers = {
  7730. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  7731. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7732. };
  7733. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards&#x27;</span>,
  7734. {
  7735. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  7736. <span class="hljs-attr">headers</span>: headers
  7737. })
  7738. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  7739. <span class="hljs-keyword">return</span> res.json();
  7740. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  7741. <span class="hljs-built_in">console</span>.log(body);
  7742. });
  7743. </code></pre>
  7744. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  7745. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  7746. headers = {
  7747. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  7748. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7749. }
  7750. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards&#x27;</span>,
  7751. <span class="hljs-symbol">params:</span> {
  7752. }, <span class="hljs-symbol">headers:</span> headers
  7753. p JSON.parse(result)
  7754. </code></pre>
  7755. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  7756. headers = {
  7757. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  7758. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7759. }
  7760. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards&#x27;</span>, headers = headers)
  7761. <span class="hljs-built_in">print</span>(r.json())
  7762. </code></pre>
  7763. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/lists/{list}/cards&quot;</span>);
  7764. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  7765. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  7766. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  7767. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  7768. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  7769. String inputLine;
  7770. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  7771. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  7772. response.append(inputLine);
  7773. }
  7774. in.close();
  7775. System.out.println(response.toString());
  7776. </code></pre>
  7777. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  7778. <span class="hljs-keyword">import</span> (
  7779. <span class="hljs-string">&quot;bytes&quot;</span>
  7780. <span class="hljs-string">&quot;net/http&quot;</span>
  7781. )
  7782. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  7783. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  7784. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  7785. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  7786. }
  7787. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  7788. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/lists/{list}/cards&quot;</span>, data)
  7789. req.Header = headers
  7790. client := &amp;http.Client{}
  7791. resp, err := client.Do(req)
  7792. <span class="hljs-comment">// ...</span>
  7793. }
  7794. </code></pre>
  7795. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  7796. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  7797. );
  7798. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  7799. <span class="hljs-comment">// Define array of request body.</span>
  7800. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  7801. <span class="hljs-keyword">try</span> {
  7802. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards&#x27;</span>, <span class="hljs-keyword">array</span>(
  7803. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  7804. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  7805. )
  7806. );
  7807. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  7808. }
  7809. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  7810. <span class="hljs-comment">// handle exception or api errors.</span>
  7811. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  7812. }
  7813. <span class="hljs-comment">// ...</span>
  7814. </code></pre>
  7815. <p><code>GET /api/boards/{board}/lists/{list}/cards</code></p>
  7816. <p><em>Get all Cards attached to a List</em></p>
  7817. <h3 id="get_all_cards-parameters">Parameters</h3>
  7818. <table>
  7819. <thead>
  7820. <tr>
  7821. <th>Name</th>
  7822. <th>In</th>
  7823. <th>Type</th>
  7824. <th>Required</th>
  7825. <th>Description</th>
  7826. </tr>
  7827. </thead>
  7828. <tbody>
  7829. <tr>
  7830. <td>board</td>
  7831. <td>path</td>
  7832. <td>string</td>
  7833. <td>true</td>
  7834. <td>the board ID</td>
  7835. </tr>
  7836. <tr>
  7837. <td>list</td>
  7838. <td>path</td>
  7839. <td>string</td>
  7840. <td>true</td>
  7841. <td>the list ID</td>
  7842. </tr>
  7843. </tbody>
  7844. </table>
  7845. <h4 id="detailed-descriptions-23">Detailed descriptions</h4>
  7846. <p><strong>board</strong>: the board ID</p>
  7847. <p><strong>list</strong>: the list ID</p>
  7848. <blockquote>
  7849. <p>Example responses</p>
  7850. </blockquote>
  7851. <blockquote>
  7852. <p>200 Response</p>
  7853. </blockquote>
  7854. <pre class="highlight tab tab-json"><code>[
  7855. {
  7856. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  7857. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  7858. <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  7859. }
  7860. ]
  7861. </code></pre>
  7862. <h3 id="get_all_cards-responses">Responses</h3>
  7863. <table>
  7864. <thead>
  7865. <tr>
  7866. <th>Status</th>
  7867. <th>Meaning</th>
  7868. <th>Description</th>
  7869. <th>Schema</th>
  7870. </tr>
  7871. </thead>
  7872. <tbody>
  7873. <tr>
  7874. <td>200</td>
  7875. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  7876. <td>200 response</td>
  7877. <td>Inline</td>
  7878. </tr>
  7879. </tbody>
  7880. </table>
  7881. <h3 id="get_all_cards-responseschema">Response Schema</h3>
  7882. <p>Status Code <strong>200</strong></p>
  7883. <table>
  7884. <thead>
  7885. <tr>
  7886. <th>Name</th>
  7887. <th>Type</th>
  7888. <th>Required</th>
  7889. <th>Restrictions</th>
  7890. <th>Description</th>
  7891. </tr>
  7892. </thead>
  7893. <tbody>
  7894. <tr>
  7895. <td>» _id</td>
  7896. <td>string</td>
  7897. <td>false</td>
  7898. <td>none</td>
  7899. <td>none</td>
  7900. </tr>
  7901. <tr>
  7902. <td>» title</td>
  7903. <td>string</td>
  7904. <td>false</td>
  7905. <td>none</td>
  7906. <td>none</td>
  7907. </tr>
  7908. <tr>
  7909. <td>» description</td>
  7910. <td>string</td>
  7911. <td>false</td>
  7912. <td>none</td>
  7913. <td>none</td>
  7914. </tr>
  7915. </tbody>
  7916. </table>
  7917. <aside class="warning">
  7918. To perform this operation, you must be authenticated by means of one of the following methods:
  7919. UserSecurity
  7920. </aside>
  7921. <h2 id="new_card">new_card</h2>
  7922. <p><a id="opIdnew_card"></a></p>
  7923. <blockquote>
  7924. <p>Code samples</p>
  7925. </blockquote>
  7926. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  7927. curl -X POST /api/boards/{board}/lists/{list}/cards \
  7928. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  7929. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  7930. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  7931. </code></pre>
  7932. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/boards/{board}/lists/{list}/cards</span> <span class="hljs-meta">HTTP/1.1</span>
  7933. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  7934. Accept: application/json
  7935. </span></code></pre>
  7936. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  7937. &quot;authorId&quot;: &quot;string&quot;,
  7938. &quot;members&quot;: &quot;string&quot;,
  7939. &quot;assignees&quot;: &quot;string&quot;,
  7940. &quot;title&quot;: &quot;string&quot;,
  7941. &quot;description&quot;: &quot;string&quot;,
  7942. &quot;swimlaneId&quot;: &quot;string&quot;
  7943. }&#x27;</span>;
  7944. <span class="hljs-keyword">const</span> headers = {
  7945. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  7946. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  7947. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7948. };
  7949. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards&#x27;</span>,
  7950. {
  7951. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  7952. <span class="hljs-attr">body</span>: inputBody,
  7953. <span class="hljs-attr">headers</span>: headers
  7954. })
  7955. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  7956. <span class="hljs-keyword">return</span> res.json();
  7957. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  7958. <span class="hljs-built_in">console</span>.log(body);
  7959. });
  7960. </code></pre>
  7961. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  7962. <span class="hljs-keyword">const</span> inputBody = {
  7963. <span class="hljs-string">&quot;authorId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  7964. <span class="hljs-string">&quot;members&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  7965. <span class="hljs-string">&quot;assignees&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  7966. <span class="hljs-string">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  7967. <span class="hljs-string">&quot;description&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  7968. <span class="hljs-string">&quot;swimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  7969. };
  7970. <span class="hljs-keyword">const</span> headers = {
  7971. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  7972. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  7973. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7974. };
  7975. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards&#x27;</span>,
  7976. {
  7977. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  7978. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  7979. <span class="hljs-attr">headers</span>: headers
  7980. })
  7981. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  7982. <span class="hljs-keyword">return</span> res.json();
  7983. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  7984. <span class="hljs-built_in">console</span>.log(body);
  7985. });
  7986. </code></pre>
  7987. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  7988. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  7989. headers = {
  7990. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  7991. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  7992. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  7993. }
  7994. result = RestClient.post <span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards&#x27;</span>,
  7995. <span class="hljs-symbol">params:</span> {
  7996. }, <span class="hljs-symbol">headers:</span> headers
  7997. p JSON.parse(result)
  7998. </code></pre>
  7999. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  8000. headers = {
  8001. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  8002. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  8003. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  8004. }
  8005. r = requests.post(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards&#x27;</span>, headers = headers)
  8006. <span class="hljs-built_in">print</span>(r.json())
  8007. </code></pre>
  8008. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/lists/{list}/cards&quot;</span>);
  8009. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  8010. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  8011. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  8012. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  8013. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  8014. String inputLine;
  8015. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  8016. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  8017. response.append(inputLine);
  8018. }
  8019. in.close();
  8020. System.out.println(response.toString());
  8021. </code></pre>
  8022. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  8023. <span class="hljs-keyword">import</span> (
  8024. <span class="hljs-string">&quot;bytes&quot;</span>
  8025. <span class="hljs-string">&quot;net/http&quot;</span>
  8026. )
  8027. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  8028. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  8029. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  8030. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  8031. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  8032. }
  8033. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  8034. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/lists/{list}/cards&quot;</span>, data)
  8035. req.Header = headers
  8036. client := &amp;http.Client{}
  8037. resp, err := client.Do(req)
  8038. <span class="hljs-comment">// ...</span>
  8039. }
  8040. </code></pre>
  8041. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  8042. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  8043. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  8044. );
  8045. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  8046. <span class="hljs-comment">// Define array of request body.</span>
  8047. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  8048. <span class="hljs-keyword">try</span> {
  8049. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards&#x27;</span>, <span class="hljs-keyword">array</span>(
  8050. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  8051. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  8052. )
  8053. );
  8054. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  8055. }
  8056. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  8057. <span class="hljs-comment">// handle exception or api errors.</span>
  8058. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  8059. }
  8060. <span class="hljs-comment">// ...</span>
  8061. </code></pre>
  8062. <p><code>POST /api/boards/{board}/lists/{list}/cards</code></p>
  8063. <p><em>Create a new Card</em></p>
  8064. <blockquote>
  8065. <p>Body parameter</p>
  8066. </blockquote>
  8067. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">authorId:</span> <span class="hljs-string">string</span>
  8068. <span class="hljs-attr">members:</span> <span class="hljs-string">string</span>
  8069. <span class="hljs-attr">assignees:</span> <span class="hljs-string">string</span>
  8070. <span class="hljs-attr">title:</span> <span class="hljs-string">string</span>
  8071. <span class="hljs-attr">description:</span> <span class="hljs-string">string</span>
  8072. <span class="hljs-attr">swimlaneId:</span> <span class="hljs-string">string</span>
  8073. </code></pre>
  8074. <h3 id="new_card-parameters">Parameters</h3>
  8075. <table>
  8076. <thead>
  8077. <tr>
  8078. <th>Name</th>
  8079. <th>In</th>
  8080. <th>Type</th>
  8081. <th>Required</th>
  8082. <th>Description</th>
  8083. </tr>
  8084. </thead>
  8085. <tbody>
  8086. <tr>
  8087. <td>board</td>
  8088. <td>path</td>
  8089. <td>string</td>
  8090. <td>true</td>
  8091. <td>the board ID of the new card</td>
  8092. </tr>
  8093. <tr>
  8094. <td>list</td>
  8095. <td>path</td>
  8096. <td>string</td>
  8097. <td>true</td>
  8098. <td>the list ID of the new card</td>
  8099. </tr>
  8100. <tr>
  8101. <td>body</td>
  8102. <td>body</td>
  8103. <td>object</td>
  8104. <td>true</td>
  8105. <td>none</td>
  8106. </tr>
  8107. <tr>
  8108. <td>» authorId</td>
  8109. <td>body</td>
  8110. <td>string</td>
  8111. <td>true</td>
  8112. <td>the authorId value</td>
  8113. </tr>
  8114. <tr>
  8115. <td>» members</td>
  8116. <td>body</td>
  8117. <td>string</td>
  8118. <td>false</td>
  8119. <td>the member IDs list of the new card</td>
  8120. </tr>
  8121. <tr>
  8122. <td>» assignees</td>
  8123. <td>body</td>
  8124. <td>string</td>
  8125. <td>false</td>
  8126. <td>the array of maximum one ID of assignee of the new card</td>
  8127. </tr>
  8128. <tr>
  8129. <td>» title</td>
  8130. <td>body</td>
  8131. <td>string</td>
  8132. <td>true</td>
  8133. <td>the title of the new card</td>
  8134. </tr>
  8135. <tr>
  8136. <td>» description</td>
  8137. <td>body</td>
  8138. <td>string</td>
  8139. <td>true</td>
  8140. <td>the description of the new card</td>
  8141. </tr>
  8142. <tr>
  8143. <td>» swimlaneId</td>
  8144. <td>body</td>
  8145. <td>string</td>
  8146. <td>true</td>
  8147. <td>the swimlane ID of the new card</td>
  8148. </tr>
  8149. </tbody>
  8150. </table>
  8151. <h4 id="detailed-descriptions-24">Detailed descriptions</h4>
  8152. <p><strong>board</strong>: the board ID of the new card</p>
  8153. <p><strong>list</strong>: the list ID of the new card</p>
  8154. <blockquote>
  8155. <p>Example responses</p>
  8156. </blockquote>
  8157. <blockquote>
  8158. <p>200 Response</p>
  8159. </blockquote>
  8160. <pre class="highlight tab tab-json"><code>{
  8161. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  8162. }
  8163. </code></pre>
  8164. <h3 id="new_card-responses">Responses</h3>
  8165. <table>
  8166. <thead>
  8167. <tr>
  8168. <th>Status</th>
  8169. <th>Meaning</th>
  8170. <th>Description</th>
  8171. <th>Schema</th>
  8172. </tr>
  8173. </thead>
  8174. <tbody>
  8175. <tr>
  8176. <td>200</td>
  8177. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  8178. <td>200 response</td>
  8179. <td>Inline</td>
  8180. </tr>
  8181. </tbody>
  8182. </table>
  8183. <h3 id="new_card-responseschema">Response Schema</h3>
  8184. <p>Status Code <strong>200</strong></p>
  8185. <table>
  8186. <thead>
  8187. <tr>
  8188. <th>Name</th>
  8189. <th>Type</th>
  8190. <th>Required</th>
  8191. <th>Restrictions</th>
  8192. <th>Description</th>
  8193. </tr>
  8194. </thead>
  8195. <tbody>
  8196. <tr>
  8197. <td>» _id</td>
  8198. <td>string</td>
  8199. <td>false</td>
  8200. <td>none</td>
  8201. <td>none</td>
  8202. </tr>
  8203. </tbody>
  8204. </table>
  8205. <aside class="warning">
  8206. To perform this operation, you must be authenticated by means of one of the following methods:
  8207. UserSecurity
  8208. </aside>
  8209. <h2 id="get_card">get_card</h2>
  8210. <p><a id="opIdget_card"></a></p>
  8211. <blockquote>
  8212. <p>Code samples</p>
  8213. </blockquote>
  8214. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  8215. curl -X GET /api/boards/{board}/lists/{list}/cards/{card} \
  8216. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  8217. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  8218. </code></pre>
  8219. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/lists/{list}/cards/{card}</span> <span class="hljs-meta">HTTP/1.1</span>
  8220. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  8221. </span></code></pre>
  8222. <pre class="highlight tab tab-javascript"><code>
  8223. <span class="hljs-keyword">const</span> headers = {
  8224. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  8225. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  8226. };
  8227. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}&#x27;</span>,
  8228. {
  8229. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  8230. <span class="hljs-attr">headers</span>: headers
  8231. })
  8232. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  8233. <span class="hljs-keyword">return</span> res.json();
  8234. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  8235. <span class="hljs-built_in">console</span>.log(body);
  8236. });
  8237. </code></pre>
  8238. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  8239. <span class="hljs-keyword">const</span> headers = {
  8240. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  8241. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  8242. };
  8243. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}&#x27;</span>,
  8244. {
  8245. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  8246. <span class="hljs-attr">headers</span>: headers
  8247. })
  8248. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  8249. <span class="hljs-keyword">return</span> res.json();
  8250. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  8251. <span class="hljs-built_in">console</span>.log(body);
  8252. });
  8253. </code></pre>
  8254. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  8255. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  8256. headers = {
  8257. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  8258. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  8259. }
  8260. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}&#x27;</span>,
  8261. <span class="hljs-symbol">params:</span> {
  8262. }, <span class="hljs-symbol">headers:</span> headers
  8263. p JSON.parse(result)
  8264. </code></pre>
  8265. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  8266. headers = {
  8267. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  8268. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  8269. }
  8270. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}&#x27;</span>, headers = headers)
  8271. <span class="hljs-built_in">print</span>(r.json())
  8272. </code></pre>
  8273. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/lists/{list}/cards/{card}&quot;</span>);
  8274. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  8275. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  8276. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  8277. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  8278. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  8279. String inputLine;
  8280. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  8281. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  8282. response.append(inputLine);
  8283. }
  8284. in.close();
  8285. System.out.println(response.toString());
  8286. </code></pre>
  8287. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  8288. <span class="hljs-keyword">import</span> (
  8289. <span class="hljs-string">&quot;bytes&quot;</span>
  8290. <span class="hljs-string">&quot;net/http&quot;</span>
  8291. )
  8292. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  8293. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  8294. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  8295. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  8296. }
  8297. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  8298. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/lists/{list}/cards/{card}&quot;</span>, data)
  8299. req.Header = headers
  8300. client := &amp;http.Client{}
  8301. resp, err := client.Do(req)
  8302. <span class="hljs-comment">// ...</span>
  8303. }
  8304. </code></pre>
  8305. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  8306. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  8307. );
  8308. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  8309. <span class="hljs-comment">// Define array of request body.</span>
  8310. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  8311. <span class="hljs-keyword">try</span> {
  8312. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}&#x27;</span>, <span class="hljs-keyword">array</span>(
  8313. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  8314. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  8315. )
  8316. );
  8317. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  8318. }
  8319. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  8320. <span class="hljs-comment">// handle exception or api errors.</span>
  8321. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  8322. }
  8323. <span class="hljs-comment">// ...</span>
  8324. </code></pre>
  8325. <p><code>GET /api/boards/{board}/lists/{list}/cards/{card}</code></p>
  8326. <p><em>Get a Card</em></p>
  8327. <h3 id="get_card-parameters">Parameters</h3>
  8328. <table>
  8329. <thead>
  8330. <tr>
  8331. <th>Name</th>
  8332. <th>In</th>
  8333. <th>Type</th>
  8334. <th>Required</th>
  8335. <th>Description</th>
  8336. </tr>
  8337. </thead>
  8338. <tbody>
  8339. <tr>
  8340. <td>board</td>
  8341. <td>path</td>
  8342. <td>string</td>
  8343. <td>true</td>
  8344. <td>the board ID</td>
  8345. </tr>
  8346. <tr>
  8347. <td>list</td>
  8348. <td>path</td>
  8349. <td>string</td>
  8350. <td>true</td>
  8351. <td>the list ID of the card</td>
  8352. </tr>
  8353. <tr>
  8354. <td>card</td>
  8355. <td>path</td>
  8356. <td>string</td>
  8357. <td>true</td>
  8358. <td>the card ID</td>
  8359. </tr>
  8360. </tbody>
  8361. </table>
  8362. <h4 id="detailed-descriptions-25">Detailed descriptions</h4>
  8363. <p><strong>board</strong>: the board ID</p>
  8364. <p><strong>list</strong>: the list ID of the card</p>
  8365. <p><strong>card</strong>: the card ID</p>
  8366. <blockquote>
  8367. <p>Example responses</p>
  8368. </blockquote>
  8369. <blockquote>
  8370. <p>200 Response</p>
  8371. </blockquote>
  8372. <pre class="highlight tab tab-json"><code>{
  8373. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8374. <span class="hljs-attr">&quot;archived&quot;</span>: <span class="hljs-literal">true</span>,
  8375. <span class="hljs-attr">&quot;archivedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8376. <span class="hljs-attr">&quot;parentId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8377. <span class="hljs-attr">&quot;listId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8378. <span class="hljs-attr">&quot;swimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8379. <span class="hljs-attr">&quot;boardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8380. <span class="hljs-attr">&quot;coverId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8381. <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;white&quot;</span>,
  8382. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8383. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8384. <span class="hljs-attr">&quot;customFields&quot;</span>: [
  8385. {}
  8386. ],
  8387. <span class="hljs-attr">&quot;dateLastActivity&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8388. <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8389. <span class="hljs-attr">&quot;requestedBy&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8390. <span class="hljs-attr">&quot;assignedBy&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8391. <span class="hljs-attr">&quot;labelIds&quot;</span>: [
  8392. <span class="hljs-string">&quot;string&quot;</span>
  8393. ],
  8394. <span class="hljs-attr">&quot;members&quot;</span>: [
  8395. <span class="hljs-string">&quot;string&quot;</span>
  8396. ],
  8397. <span class="hljs-attr">&quot;assignees&quot;</span>: [
  8398. <span class="hljs-string">&quot;string&quot;</span>
  8399. ],
  8400. <span class="hljs-attr">&quot;receivedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8401. <span class="hljs-attr">&quot;startAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8402. <span class="hljs-attr">&quot;dueAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8403. <span class="hljs-attr">&quot;endAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8404. <span class="hljs-attr">&quot;spentTime&quot;</span>: <span class="hljs-number">0</span>,
  8405. <span class="hljs-attr">&quot;isOvertime&quot;</span>: <span class="hljs-literal">true</span>,
  8406. <span class="hljs-attr">&quot;userId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8407. <span class="hljs-attr">&quot;sort&quot;</span>: <span class="hljs-number">0</span>,
  8408. <span class="hljs-attr">&quot;subtaskSort&quot;</span>: <span class="hljs-number">0</span>,
  8409. <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8410. <span class="hljs-attr">&quot;linkedId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8411. <span class="hljs-attr">&quot;vote&quot;</span>: {
  8412. <span class="hljs-attr">&quot;question&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8413. <span class="hljs-attr">&quot;positive&quot;</span>: [
  8414. <span class="hljs-string">&quot;string&quot;</span>
  8415. ],
  8416. <span class="hljs-attr">&quot;negative&quot;</span>: [
  8417. <span class="hljs-string">&quot;string&quot;</span>
  8418. ],
  8419. <span class="hljs-attr">&quot;end&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8420. <span class="hljs-attr">&quot;public&quot;</span>: <span class="hljs-literal">true</span>,
  8421. <span class="hljs-attr">&quot;allowNonBoardMembers&quot;</span>: <span class="hljs-literal">true</span>
  8422. },
  8423. <span class="hljs-attr">&quot;poker&quot;</span>: {
  8424. <span class="hljs-attr">&quot;question&quot;</span>: <span class="hljs-literal">true</span>,
  8425. <span class="hljs-attr">&quot;one&quot;</span>: [
  8426. <span class="hljs-string">&quot;string&quot;</span>
  8427. ],
  8428. <span class="hljs-attr">&quot;two&quot;</span>: [
  8429. <span class="hljs-string">&quot;string&quot;</span>
  8430. ],
  8431. <span class="hljs-attr">&quot;three&quot;</span>: [
  8432. <span class="hljs-string">&quot;string&quot;</span>
  8433. ],
  8434. <span class="hljs-attr">&quot;five&quot;</span>: [
  8435. <span class="hljs-string">&quot;string&quot;</span>
  8436. ],
  8437. <span class="hljs-attr">&quot;eight&quot;</span>: [
  8438. <span class="hljs-string">&quot;string&quot;</span>
  8439. ],
  8440. <span class="hljs-attr">&quot;thirteen&quot;</span>: [
  8441. <span class="hljs-string">&quot;string&quot;</span>
  8442. ],
  8443. <span class="hljs-attr">&quot;twenty&quot;</span>: [
  8444. <span class="hljs-string">&quot;string&quot;</span>
  8445. ],
  8446. <span class="hljs-attr">&quot;forty&quot;</span>: [
  8447. <span class="hljs-string">&quot;string&quot;</span>
  8448. ],
  8449. <span class="hljs-attr">&quot;oneHundred&quot;</span>: [
  8450. <span class="hljs-string">&quot;string&quot;</span>
  8451. ],
  8452. <span class="hljs-attr">&quot;unsure&quot;</span>: [
  8453. <span class="hljs-string">&quot;string&quot;</span>
  8454. ],
  8455. <span class="hljs-attr">&quot;end&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8456. <span class="hljs-attr">&quot;allowNonBoardMembers&quot;</span>: <span class="hljs-literal">true</span>,
  8457. <span class="hljs-attr">&quot;estimation&quot;</span>: <span class="hljs-number">0</span>
  8458. },
  8459. <span class="hljs-attr">&quot;targetId_gantt&quot;</span>: [
  8460. <span class="hljs-string">&quot;string&quot;</span>
  8461. ],
  8462. <span class="hljs-attr">&quot;linkType_gantt&quot;</span>: [
  8463. <span class="hljs-number">0</span>
  8464. ],
  8465. <span class="hljs-attr">&quot;linkId_gantt&quot;</span>: [
  8466. <span class="hljs-string">&quot;string&quot;</span>
  8467. ],
  8468. <span class="hljs-attr">&quot;cardNumber&quot;</span>: <span class="hljs-number">0</span>
  8469. }
  8470. </code></pre>
  8471. <h3 id="get_card-responses">Responses</h3>
  8472. <table>
  8473. <thead>
  8474. <tr>
  8475. <th>Status</th>
  8476. <th>Meaning</th>
  8477. <th>Description</th>
  8478. <th>Schema</th>
  8479. </tr>
  8480. </thead>
  8481. <tbody>
  8482. <tr>
  8483. <td>200</td>
  8484. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  8485. <td>200 response</td>
  8486. <td><a href="#schemacards">Cards</a></td>
  8487. </tr>
  8488. </tbody>
  8489. </table>
  8490. <aside class="warning">
  8491. To perform this operation, you must be authenticated by means of one of the following methods:
  8492. UserSecurity
  8493. </aside>
  8494. <h2 id="edit_card">edit_card</h2>
  8495. <p><a id="opIdedit_card"></a></p>
  8496. <blockquote>
  8497. <p>Code samples</p>
  8498. </blockquote>
  8499. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  8500. curl -X PUT /api/boards/{board}/lists/{list}/cards/{card} \
  8501. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  8502. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  8503. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  8504. </code></pre>
  8505. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">PUT</span> <span class="hljs-string">/api/boards/{board}/lists/{list}/cards/{card}</span> <span class="hljs-meta">HTTP/1.1</span>
  8506. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  8507. Accept: application/json
  8508. </span></code></pre>
  8509. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  8510. &quot;title&quot;: &quot;string&quot;,
  8511. &quot;sort&quot;: &quot;string&quot;,
  8512. &quot;parentId&quot;: &quot;string&quot;,
  8513. &quot;description&quot;: &quot;string&quot;,
  8514. &quot;color&quot;: &quot;string&quot;,
  8515. &quot;vote&quot;: {},
  8516. &quot;poker&quot;: {},
  8517. &quot;labelIds&quot;: &quot;string&quot;,
  8518. &quot;requestedBy&quot;: &quot;string&quot;,
  8519. &quot;assignedBy&quot;: &quot;string&quot;,
  8520. &quot;receivedAt&quot;: &quot;string&quot;,
  8521. &quot;startAt&quot;: &quot;string&quot;,
  8522. &quot;dueAt&quot;: &quot;string&quot;,
  8523. &quot;endAt&quot;: &quot;string&quot;,
  8524. &quot;spentTime&quot;: &quot;string&quot;,
  8525. &quot;isOverTime&quot;: true,
  8526. &quot;customFields&quot;: &quot;string&quot;,
  8527. &quot;members&quot;: &quot;string&quot;,
  8528. &quot;assignees&quot;: &quot;string&quot;,
  8529. &quot;swimlaneId&quot;: &quot;string&quot;,
  8530. &quot;listId&quot;: &quot;string&quot;,
  8531. &quot;authorId&quot;: &quot;string&quot;
  8532. }&#x27;</span>;
  8533. <span class="hljs-keyword">const</span> headers = {
  8534. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  8535. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  8536. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  8537. };
  8538. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}&#x27;</span>,
  8539. {
  8540. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;PUT&#x27;</span>,
  8541. <span class="hljs-attr">body</span>: inputBody,
  8542. <span class="hljs-attr">headers</span>: headers
  8543. })
  8544. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  8545. <span class="hljs-keyword">return</span> res.json();
  8546. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  8547. <span class="hljs-built_in">console</span>.log(body);
  8548. });
  8549. </code></pre>
  8550. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  8551. <span class="hljs-keyword">const</span> inputBody = {
  8552. <span class="hljs-string">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8553. <span class="hljs-string">&quot;sort&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8554. <span class="hljs-string">&quot;parentId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8555. <span class="hljs-string">&quot;description&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8556. <span class="hljs-string">&quot;color&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8557. <span class="hljs-string">&quot;vote&quot;</span>: {},
  8558. <span class="hljs-string">&quot;poker&quot;</span>: {},
  8559. <span class="hljs-string">&quot;labelIds&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8560. <span class="hljs-string">&quot;requestedBy&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8561. <span class="hljs-string">&quot;assignedBy&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8562. <span class="hljs-string">&quot;receivedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8563. <span class="hljs-string">&quot;startAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8564. <span class="hljs-string">&quot;dueAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8565. <span class="hljs-string">&quot;endAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8566. <span class="hljs-string">&quot;spentTime&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8567. <span class="hljs-string">&quot;isOverTime&quot;</span>: <span class="hljs-literal">true</span>,
  8568. <span class="hljs-string">&quot;customFields&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8569. <span class="hljs-string">&quot;members&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8570. <span class="hljs-string">&quot;assignees&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8571. <span class="hljs-string">&quot;swimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8572. <span class="hljs-string">&quot;listId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  8573. <span class="hljs-string">&quot;authorId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  8574. };
  8575. <span class="hljs-keyword">const</span> headers = {
  8576. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  8577. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  8578. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  8579. };
  8580. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}&#x27;</span>,
  8581. {
  8582. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;PUT&#x27;</span>,
  8583. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  8584. <span class="hljs-attr">headers</span>: headers
  8585. })
  8586. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  8587. <span class="hljs-keyword">return</span> res.json();
  8588. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  8589. <span class="hljs-built_in">console</span>.log(body);
  8590. });
  8591. </code></pre>
  8592. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  8593. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  8594. headers = {
  8595. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  8596. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  8597. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  8598. }
  8599. result = RestClient.put <span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}&#x27;</span>,
  8600. <span class="hljs-symbol">params:</span> {
  8601. }, <span class="hljs-symbol">headers:</span> headers
  8602. p JSON.parse(result)
  8603. </code></pre>
  8604. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  8605. headers = {
  8606. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  8607. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  8608. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  8609. }
  8610. r = requests.put(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}&#x27;</span>, headers = headers)
  8611. <span class="hljs-built_in">print</span>(r.json())
  8612. </code></pre>
  8613. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/lists/{list}/cards/{card}&quot;</span>);
  8614. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  8615. con.setRequestMethod(<span class="hljs-string">&quot;PUT&quot;</span>);
  8616. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  8617. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  8618. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  8619. String inputLine;
  8620. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  8621. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  8622. response.append(inputLine);
  8623. }
  8624. in.close();
  8625. System.out.println(response.toString());
  8626. </code></pre>
  8627. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  8628. <span class="hljs-keyword">import</span> (
  8629. <span class="hljs-string">&quot;bytes&quot;</span>
  8630. <span class="hljs-string">&quot;net/http&quot;</span>
  8631. )
  8632. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  8633. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  8634. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  8635. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  8636. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  8637. }
  8638. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  8639. req, err := http.NewRequest(<span class="hljs-string">&quot;PUT&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/lists/{list}/cards/{card}&quot;</span>, data)
  8640. req.Header = headers
  8641. client := &amp;http.Client{}
  8642. resp, err := client.Do(req)
  8643. <span class="hljs-comment">// ...</span>
  8644. }
  8645. </code></pre>
  8646. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  8647. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  8648. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  8649. );
  8650. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  8651. <span class="hljs-comment">// Define array of request body.</span>
  8652. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  8653. <span class="hljs-keyword">try</span> {
  8654. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;PUT&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}&#x27;</span>, <span class="hljs-keyword">array</span>(
  8655. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  8656. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  8657. )
  8658. );
  8659. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  8660. }
  8661. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  8662. <span class="hljs-comment">// handle exception or api errors.</span>
  8663. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  8664. }
  8665. <span class="hljs-comment">// ...</span>
  8666. </code></pre>
  8667. <p><code>PUT /api/boards/{board}/lists/{list}/cards/{card}</code></p>
  8668. <p><em>Edit Fields in a Card</em></p>
  8669. <p>Edit a card</p>
  8670. <p>The color has to be chosen between <code>white</code>, <code>green</code>, <code>yellow</code>, <code>orange</code>,
  8671. <code>red</code>, <code>purple</code>, <code>blue</code>, <code>sky</code>, <code>lime</code>, <code>pink</code>, <code>black</code>, <code>silver</code>,
  8672. <code>peachpuff</code>, <code>crimson</code>, <code>plum</code>, <code>darkgreen</code>, <code>slateblue</code>, <code>magenta</code>,
  8673. <code>gold</code>, <code>navy</code>, <code>gray</code>, <code>saddlebrown</code>, <code>paleturquoise</code>, <code>mistyrose</code>,
  8674. <code>indigo</code>:</p>
  8675. <img src="/card-colors.png" alt="Wekan card colors" />
  8676. <p>Note: setting the color to white has the same effect than removing it.</p>
  8677. <blockquote>
  8678. <p>Body parameter</p>
  8679. </blockquote>
  8680. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">title:</span> <span class="hljs-string">string</span>
  8681. <span class="hljs-attr">sort:</span> <span class="hljs-string">string</span>
  8682. <span class="hljs-attr">parentId:</span> <span class="hljs-string">string</span>
  8683. <span class="hljs-attr">description:</span> <span class="hljs-string">string</span>
  8684. <span class="hljs-attr">color:</span> <span class="hljs-string">string</span>
  8685. <span class="hljs-attr">vote:</span> {}
  8686. <span class="hljs-attr">poker:</span> {}
  8687. <span class="hljs-attr">labelIds:</span> <span class="hljs-string">string</span>
  8688. <span class="hljs-attr">requestedBy:</span> <span class="hljs-string">string</span>
  8689. <span class="hljs-attr">assignedBy:</span> <span class="hljs-string">string</span>
  8690. <span class="hljs-attr">receivedAt:</span> <span class="hljs-string">string</span>
  8691. <span class="hljs-attr">startAt:</span> <span class="hljs-string">string</span>
  8692. <span class="hljs-attr">dueAt:</span> <span class="hljs-string">string</span>
  8693. <span class="hljs-attr">endAt:</span> <span class="hljs-string">string</span>
  8694. <span class="hljs-attr">spentTime:</span> <span class="hljs-string">string</span>
  8695. <span class="hljs-attr">isOverTime:</span> <span class="hljs-literal">true</span>
  8696. <span class="hljs-attr">customFields:</span> <span class="hljs-string">string</span>
  8697. <span class="hljs-attr">members:</span> <span class="hljs-string">string</span>
  8698. <span class="hljs-attr">assignees:</span> <span class="hljs-string">string</span>
  8699. <span class="hljs-attr">swimlaneId:</span> <span class="hljs-string">string</span>
  8700. <span class="hljs-attr">listId:</span> <span class="hljs-string">string</span>
  8701. <span class="hljs-attr">authorId:</span> <span class="hljs-string">string</span>
  8702. </code></pre>
  8703. <h3 id="edit_card-parameters">Parameters</h3>
  8704. <table>
  8705. <thead>
  8706. <tr>
  8707. <th>Name</th>
  8708. <th>In</th>
  8709. <th>Type</th>
  8710. <th>Required</th>
  8711. <th>Description</th>
  8712. </tr>
  8713. </thead>
  8714. <tbody>
  8715. <tr>
  8716. <td>board</td>
  8717. <td>path</td>
  8718. <td>string</td>
  8719. <td>true</td>
  8720. <td>the board ID of the card</td>
  8721. </tr>
  8722. <tr>
  8723. <td>list</td>
  8724. <td>path</td>
  8725. <td>string</td>
  8726. <td>true</td>
  8727. <td>the list ID of the card</td>
  8728. </tr>
  8729. <tr>
  8730. <td>card</td>
  8731. <td>path</td>
  8732. <td>string</td>
  8733. <td>true</td>
  8734. <td>the ID of the card</td>
  8735. </tr>
  8736. <tr>
  8737. <td>body</td>
  8738. <td>body</td>
  8739. <td>object</td>
  8740. <td>false</td>
  8741. <td>none</td>
  8742. </tr>
  8743. <tr>
  8744. <td>» title</td>
  8745. <td>body</td>
  8746. <td>string</td>
  8747. <td>false</td>
  8748. <td>the new title of the card</td>
  8749. </tr>
  8750. <tr>
  8751. <td>» sort</td>
  8752. <td>body</td>
  8753. <td>string</td>
  8754. <td>false</td>
  8755. <td>the new sort value of the card</td>
  8756. </tr>
  8757. <tr>
  8758. <td>» parentId</td>
  8759. <td>body</td>
  8760. <td>string</td>
  8761. <td>false</td>
  8762. <td>change the parent of the card</td>
  8763. </tr>
  8764. <tr>
  8765. <td>» description</td>
  8766. <td>body</td>
  8767. <td>string</td>
  8768. <td>false</td>
  8769. <td>the new description of the card</td>
  8770. </tr>
  8771. <tr>
  8772. <td>» color</td>
  8773. <td>body</td>
  8774. <td>string</td>
  8775. <td>false</td>
  8776. <td>the new color of the card</td>
  8777. </tr>
  8778. <tr>
  8779. <td>» vote</td>
  8780. <td>body</td>
  8781. <td>object</td>
  8782. <td>false</td>
  8783. <td>the vote object</td>
  8784. </tr>
  8785. <tr>
  8786. <td>» poker</td>
  8787. <td>body</td>
  8788. <td>object</td>
  8789. <td>false</td>
  8790. <td>the poker object</td>
  8791. </tr>
  8792. <tr>
  8793. <td>» labelIds</td>
  8794. <td>body</td>
  8795. <td>string</td>
  8796. <td>false</td>
  8797. <td>the new list of label IDs attached to the card</td>
  8798. </tr>
  8799. <tr>
  8800. <td>» requestedBy</td>
  8801. <td>body</td>
  8802. <td>string</td>
  8803. <td>false</td>
  8804. <td>the new requestedBy field of the card</td>
  8805. </tr>
  8806. <tr>
  8807. <td>» assignedBy</td>
  8808. <td>body</td>
  8809. <td>string</td>
  8810. <td>false</td>
  8811. <td>the new assignedBy field of the card</td>
  8812. </tr>
  8813. <tr>
  8814. <td>» receivedAt</td>
  8815. <td>body</td>
  8816. <td>string</td>
  8817. <td>false</td>
  8818. <td>the new receivedAt field of the card</td>
  8819. </tr>
  8820. <tr>
  8821. <td>» startAt</td>
  8822. <td>body</td>
  8823. <td>string</td>
  8824. <td>false</td>
  8825. <td>the new startAt field of the card</td>
  8826. </tr>
  8827. <tr>
  8828. <td>» dueAt</td>
  8829. <td>body</td>
  8830. <td>string</td>
  8831. <td>false</td>
  8832. <td>the new dueAt field of the card</td>
  8833. </tr>
  8834. <tr>
  8835. <td>» endAt</td>
  8836. <td>body</td>
  8837. <td>string</td>
  8838. <td>false</td>
  8839. <td>the new endAt field of the card</td>
  8840. </tr>
  8841. <tr>
  8842. <td>» spentTime</td>
  8843. <td>body</td>
  8844. <td>string</td>
  8845. <td>false</td>
  8846. <td>the new spentTime field of the card</td>
  8847. </tr>
  8848. <tr>
  8849. <td>» isOverTime</td>
  8850. <td>body</td>
  8851. <td>boolean</td>
  8852. <td>false</td>
  8853. <td>the new isOverTime field of the card</td>
  8854. </tr>
  8855. <tr>
  8856. <td>» customFields</td>
  8857. <td>body</td>
  8858. <td>string</td>
  8859. <td>false</td>
  8860. <td>the new customFields value of the card</td>
  8861. </tr>
  8862. <tr>
  8863. <td>» members</td>
  8864. <td>body</td>
  8865. <td>string</td>
  8866. <td>false</td>
  8867. <td>the new list of member IDs attached to the card</td>
  8868. </tr>
  8869. <tr>
  8870. <td>» assignees</td>
  8871. <td>body</td>
  8872. <td>string</td>
  8873. <td>false</td>
  8874. <td>the array of maximum one ID of assignee attached to the card</td>
  8875. </tr>
  8876. <tr>
  8877. <td>» swimlaneId</td>
  8878. <td>body</td>
  8879. <td>string</td>
  8880. <td>false</td>
  8881. <td>the new swimlane ID of the card</td>
  8882. </tr>
  8883. <tr>
  8884. <td>» listId</td>
  8885. <td>body</td>
  8886. <td>string</td>
  8887. <td>false</td>
  8888. <td>the new list ID of the card (move operation)</td>
  8889. </tr>
  8890. <tr>
  8891. <td>» authorId</td>
  8892. <td>body</td>
  8893. <td>string</td>
  8894. <td>false</td>
  8895. <td>change the owner of the card</td>
  8896. </tr>
  8897. </tbody>
  8898. </table>
  8899. <h4 id="detailed-descriptions-26">Detailed descriptions</h4>
  8900. <p><strong>board</strong>: the board ID of the card</p>
  8901. <p><strong>list</strong>: the list ID of the card</p>
  8902. <p><strong>card</strong>: the ID of the card</p>
  8903. <blockquote>
  8904. <p>Example responses</p>
  8905. </blockquote>
  8906. <blockquote>
  8907. <p>200 Response</p>
  8908. </blockquote>
  8909. <pre class="highlight tab tab-json"><code>{
  8910. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  8911. }
  8912. </code></pre>
  8913. <h3 id="edit_card-responses">Responses</h3>
  8914. <table>
  8915. <thead>
  8916. <tr>
  8917. <th>Status</th>
  8918. <th>Meaning</th>
  8919. <th>Description</th>
  8920. <th>Schema</th>
  8921. </tr>
  8922. </thead>
  8923. <tbody>
  8924. <tr>
  8925. <td>200</td>
  8926. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  8927. <td>200 response</td>
  8928. <td>Inline</td>
  8929. </tr>
  8930. </tbody>
  8931. </table>
  8932. <h3 id="edit_card-responseschema">Response Schema</h3>
  8933. <p>Status Code <strong>200</strong></p>
  8934. <table>
  8935. <thead>
  8936. <tr>
  8937. <th>Name</th>
  8938. <th>Type</th>
  8939. <th>Required</th>
  8940. <th>Restrictions</th>
  8941. <th>Description</th>
  8942. </tr>
  8943. </thead>
  8944. <tbody>
  8945. <tr>
  8946. <td>» _id</td>
  8947. <td>string</td>
  8948. <td>false</td>
  8949. <td>none</td>
  8950. <td>none</td>
  8951. </tr>
  8952. </tbody>
  8953. </table>
  8954. <aside class="warning">
  8955. To perform this operation, you must be authenticated by means of one of the following methods:
  8956. UserSecurity
  8957. </aside>
  8958. <h2 id="delete_card">delete_card</h2>
  8959. <p><a id="opIddelete_card"></a></p>
  8960. <blockquote>
  8961. <p>Code samples</p>
  8962. </blockquote>
  8963. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  8964. curl -X DELETE /api/boards/{board}/lists/{list}/cards/{card} \
  8965. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  8966. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  8967. </code></pre>
  8968. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">DELETE</span> <span class="hljs-string">/api/boards/{board}/lists/{list}/cards/{card}</span> <span class="hljs-meta">HTTP/1.1</span>
  8969. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  8970. </span></code></pre>
  8971. <pre class="highlight tab tab-javascript"><code>
  8972. <span class="hljs-keyword">const</span> headers = {
  8973. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  8974. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  8975. };
  8976. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}&#x27;</span>,
  8977. {
  8978. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  8979. <span class="hljs-attr">headers</span>: headers
  8980. })
  8981. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  8982. <span class="hljs-keyword">return</span> res.json();
  8983. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  8984. <span class="hljs-built_in">console</span>.log(body);
  8985. });
  8986. </code></pre>
  8987. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  8988. <span class="hljs-keyword">const</span> headers = {
  8989. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  8990. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  8991. };
  8992. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}&#x27;</span>,
  8993. {
  8994. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  8995. <span class="hljs-attr">headers</span>: headers
  8996. })
  8997. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  8998. <span class="hljs-keyword">return</span> res.json();
  8999. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  9000. <span class="hljs-built_in">console</span>.log(body);
  9001. });
  9002. </code></pre>
  9003. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  9004. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  9005. headers = {
  9006. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  9007. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9008. }
  9009. result = RestClient.delete <span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}&#x27;</span>,
  9010. <span class="hljs-symbol">params:</span> {
  9011. }, <span class="hljs-symbol">headers:</span> headers
  9012. p JSON.parse(result)
  9013. </code></pre>
  9014. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  9015. headers = {
  9016. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  9017. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9018. }
  9019. r = requests.delete(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}&#x27;</span>, headers = headers)
  9020. <span class="hljs-built_in">print</span>(r.json())
  9021. </code></pre>
  9022. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/lists/{list}/cards/{card}&quot;</span>);
  9023. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  9024. con.setRequestMethod(<span class="hljs-string">&quot;DELETE&quot;</span>);
  9025. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  9026. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  9027. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  9028. String inputLine;
  9029. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  9030. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  9031. response.append(inputLine);
  9032. }
  9033. in.close();
  9034. System.out.println(response.toString());
  9035. </code></pre>
  9036. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  9037. <span class="hljs-keyword">import</span> (
  9038. <span class="hljs-string">&quot;bytes&quot;</span>
  9039. <span class="hljs-string">&quot;net/http&quot;</span>
  9040. )
  9041. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  9042. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  9043. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  9044. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  9045. }
  9046. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  9047. req, err := http.NewRequest(<span class="hljs-string">&quot;DELETE&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/lists/{list}/cards/{card}&quot;</span>, data)
  9048. req.Header = headers
  9049. client := &amp;http.Client{}
  9050. resp, err := client.Do(req)
  9051. <span class="hljs-comment">// ...</span>
  9052. }
  9053. </code></pre>
  9054. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  9055. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  9056. );
  9057. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  9058. <span class="hljs-comment">// Define array of request body.</span>
  9059. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  9060. <span class="hljs-keyword">try</span> {
  9061. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;DELETE&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}&#x27;</span>, <span class="hljs-keyword">array</span>(
  9062. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  9063. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  9064. )
  9065. );
  9066. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  9067. }
  9068. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  9069. <span class="hljs-comment">// handle exception or api errors.</span>
  9070. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  9071. }
  9072. <span class="hljs-comment">// ...</span>
  9073. </code></pre>
  9074. <p><code>DELETE /api/boards/{board}/lists/{list}/cards/{card}</code></p>
  9075. <p><em>Delete a card from a board</em></p>
  9076. <p>This operation <strong>deletes</strong> a card, and therefore the card
  9077. is not put in the recycle bin.</p>
  9078. <h3 id="delete_card-parameters">Parameters</h3>
  9079. <table>
  9080. <thead>
  9081. <tr>
  9082. <th>Name</th>
  9083. <th>In</th>
  9084. <th>Type</th>
  9085. <th>Required</th>
  9086. <th>Description</th>
  9087. </tr>
  9088. </thead>
  9089. <tbody>
  9090. <tr>
  9091. <td>board</td>
  9092. <td>path</td>
  9093. <td>string</td>
  9094. <td>true</td>
  9095. <td>the board ID of the card</td>
  9096. </tr>
  9097. <tr>
  9098. <td>list</td>
  9099. <td>path</td>
  9100. <td>string</td>
  9101. <td>true</td>
  9102. <td>the list ID of the card</td>
  9103. </tr>
  9104. <tr>
  9105. <td>card</td>
  9106. <td>path</td>
  9107. <td>string</td>
  9108. <td>true</td>
  9109. <td>the ID of the card</td>
  9110. </tr>
  9111. </tbody>
  9112. </table>
  9113. <h4 id="detailed-descriptions-27">Detailed descriptions</h4>
  9114. <p><strong>board</strong>: the board ID of the card</p>
  9115. <p><strong>list</strong>: the list ID of the card</p>
  9116. <p><strong>card</strong>: the ID of the card</p>
  9117. <blockquote>
  9118. <p>Example responses</p>
  9119. </blockquote>
  9120. <blockquote>
  9121. <p>200 Response</p>
  9122. </blockquote>
  9123. <pre class="highlight tab tab-json"><code>{
  9124. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  9125. }
  9126. </code></pre>
  9127. <h3 id="delete_card-responses">Responses</h3>
  9128. <table>
  9129. <thead>
  9130. <tr>
  9131. <th>Status</th>
  9132. <th>Meaning</th>
  9133. <th>Description</th>
  9134. <th>Schema</th>
  9135. </tr>
  9136. </thead>
  9137. <tbody>
  9138. <tr>
  9139. <td>200</td>
  9140. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  9141. <td>200 response</td>
  9142. <td>Inline</td>
  9143. </tr>
  9144. </tbody>
  9145. </table>
  9146. <h3 id="delete_card-responseschema">Response Schema</h3>
  9147. <p>Status Code <strong>200</strong></p>
  9148. <table>
  9149. <thead>
  9150. <tr>
  9151. <th>Name</th>
  9152. <th>Type</th>
  9153. <th>Required</th>
  9154. <th>Restrictions</th>
  9155. <th>Description</th>
  9156. </tr>
  9157. </thead>
  9158. <tbody>
  9159. <tr>
  9160. <td>» _id</td>
  9161. <td>string</td>
  9162. <td>false</td>
  9163. <td>none</td>
  9164. <td>none</td>
  9165. </tr>
  9166. </tbody>
  9167. </table>
  9168. <aside class="warning">
  9169. To perform this operation, you must be authenticated by means of one of the following methods:
  9170. UserSecurity
  9171. </aside>
  9172. <h2 id="edit_card_custom_field">edit_card_custom_field</h2>
  9173. <p><a id="opIdedit_card_custom_field"></a></p>
  9174. <blockquote>
  9175. <p>Code samples</p>
  9176. </blockquote>
  9177. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  9178. curl -X POST /api/boards/{board}/lists/{list}/cards/{card}/customFields/{customField} \
  9179. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  9180. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  9181. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  9182. </code></pre>
  9183. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/boards/{board}/lists/{list}/cards/{card}/customFields/{customField}</span> <span class="hljs-meta">HTTP/1.1</span>
  9184. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  9185. Accept: application/json
  9186. </span></code></pre>
  9187. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  9188. &quot;value&quot;: &quot;string&quot;
  9189. }&#x27;</span>;
  9190. <span class="hljs-keyword">const</span> headers = {
  9191. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  9192. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  9193. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9194. };
  9195. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}/customFields/{customField}&#x27;</span>,
  9196. {
  9197. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  9198. <span class="hljs-attr">body</span>: inputBody,
  9199. <span class="hljs-attr">headers</span>: headers
  9200. })
  9201. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  9202. <span class="hljs-keyword">return</span> res.json();
  9203. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  9204. <span class="hljs-built_in">console</span>.log(body);
  9205. });
  9206. </code></pre>
  9207. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  9208. <span class="hljs-keyword">const</span> inputBody = {
  9209. <span class="hljs-string">&quot;value&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  9210. };
  9211. <span class="hljs-keyword">const</span> headers = {
  9212. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  9213. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  9214. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9215. };
  9216. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}/customFields/{customField}&#x27;</span>,
  9217. {
  9218. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  9219. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  9220. <span class="hljs-attr">headers</span>: headers
  9221. })
  9222. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  9223. <span class="hljs-keyword">return</span> res.json();
  9224. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  9225. <span class="hljs-built_in">console</span>.log(body);
  9226. });
  9227. </code></pre>
  9228. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  9229. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  9230. headers = {
  9231. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  9232. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  9233. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9234. }
  9235. result = RestClient.post <span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}/customFields/{customField}&#x27;</span>,
  9236. <span class="hljs-symbol">params:</span> {
  9237. }, <span class="hljs-symbol">headers:</span> headers
  9238. p JSON.parse(result)
  9239. </code></pre>
  9240. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  9241. headers = {
  9242. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  9243. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  9244. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9245. }
  9246. r = requests.post(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}/customFields/{customField}&#x27;</span>, headers = headers)
  9247. <span class="hljs-built_in">print</span>(r.json())
  9248. </code></pre>
  9249. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/lists/{list}/cards/{card}/customFields/{customField}&quot;</span>);
  9250. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  9251. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  9252. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  9253. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  9254. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  9255. String inputLine;
  9256. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  9257. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  9258. response.append(inputLine);
  9259. }
  9260. in.close();
  9261. System.out.println(response.toString());
  9262. </code></pre>
  9263. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  9264. <span class="hljs-keyword">import</span> (
  9265. <span class="hljs-string">&quot;bytes&quot;</span>
  9266. <span class="hljs-string">&quot;net/http&quot;</span>
  9267. )
  9268. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  9269. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  9270. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  9271. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  9272. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  9273. }
  9274. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  9275. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/lists/{list}/cards/{card}/customFields/{customField}&quot;</span>, data)
  9276. req.Header = headers
  9277. client := &amp;http.Client{}
  9278. resp, err := client.Do(req)
  9279. <span class="hljs-comment">// ...</span>
  9280. }
  9281. </code></pre>
  9282. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  9283. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  9284. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  9285. );
  9286. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  9287. <span class="hljs-comment">// Define array of request body.</span>
  9288. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  9289. <span class="hljs-keyword">try</span> {
  9290. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards/{card}/customFields/{customField}&#x27;</span>, <span class="hljs-keyword">array</span>(
  9291. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  9292. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  9293. )
  9294. );
  9295. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  9296. }
  9297. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  9298. <span class="hljs-comment">// handle exception or api errors.</span>
  9299. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  9300. }
  9301. <span class="hljs-comment">// ...</span>
  9302. </code></pre>
  9303. <p><code>POST /api/boards/{board}/lists/{list}/cards/{card}/customFields/{customField}</code></p>
  9304. <p><em>Edit Custom Field in a Card</em></p>
  9305. <p>Edit a custom field value in a card</p>
  9306. <blockquote>
  9307. <p>Body parameter</p>
  9308. </blockquote>
  9309. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">value:</span> <span class="hljs-string">string</span>
  9310. </code></pre>
  9311. <h3 id="edit_card_custom_field-parameters">Parameters</h3>
  9312. <table>
  9313. <thead>
  9314. <tr>
  9315. <th>Name</th>
  9316. <th>In</th>
  9317. <th>Type</th>
  9318. <th>Required</th>
  9319. <th>Description</th>
  9320. </tr>
  9321. </thead>
  9322. <tbody>
  9323. <tr>
  9324. <td>board</td>
  9325. <td>path</td>
  9326. <td>string</td>
  9327. <td>true</td>
  9328. <td>the board ID of the card</td>
  9329. </tr>
  9330. <tr>
  9331. <td>list</td>
  9332. <td>path</td>
  9333. <td>string</td>
  9334. <td>true</td>
  9335. <td>the list ID of the card</td>
  9336. </tr>
  9337. <tr>
  9338. <td>card</td>
  9339. <td>path</td>
  9340. <td>string</td>
  9341. <td>true</td>
  9342. <td>the ID of the card</td>
  9343. </tr>
  9344. <tr>
  9345. <td>customField</td>
  9346. <td>path</td>
  9347. <td>string</td>
  9348. <td>true</td>
  9349. <td>the ID of the custom field</td>
  9350. </tr>
  9351. <tr>
  9352. <td>body</td>
  9353. <td>body</td>
  9354. <td>object</td>
  9355. <td>true</td>
  9356. <td>none</td>
  9357. </tr>
  9358. <tr>
  9359. <td>» value</td>
  9360. <td>body</td>
  9361. <td>string</td>
  9362. <td>true</td>
  9363. <td>the new custom field value</td>
  9364. </tr>
  9365. </tbody>
  9366. </table>
  9367. <h4 id="detailed-descriptions-28">Detailed descriptions</h4>
  9368. <p><strong>board</strong>: the board ID of the card</p>
  9369. <p><strong>list</strong>: the list ID of the card</p>
  9370. <p><strong>card</strong>: the ID of the card</p>
  9371. <p><strong>customField</strong>: the ID of the custom field</p>
  9372. <blockquote>
  9373. <p>Example responses</p>
  9374. </blockquote>
  9375. <blockquote>
  9376. <p>200 Response</p>
  9377. </blockquote>
  9378. <pre class="highlight tab tab-json"><code>{
  9379. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  9380. <span class="hljs-attr">&quot;customFields&quot;</span>: {}
  9381. }
  9382. </code></pre>
  9383. <h3 id="edit_card_custom_field-responses">Responses</h3>
  9384. <table>
  9385. <thead>
  9386. <tr>
  9387. <th>Status</th>
  9388. <th>Meaning</th>
  9389. <th>Description</th>
  9390. <th>Schema</th>
  9391. </tr>
  9392. </thead>
  9393. <tbody>
  9394. <tr>
  9395. <td>200</td>
  9396. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  9397. <td>200 response</td>
  9398. <td>Inline</td>
  9399. </tr>
  9400. </tbody>
  9401. </table>
  9402. <h3 id="edit_card_custom_field-responseschema">Response Schema</h3>
  9403. <p>Status Code <strong>200</strong></p>
  9404. <table>
  9405. <thead>
  9406. <tr>
  9407. <th>Name</th>
  9408. <th>Type</th>
  9409. <th>Required</th>
  9410. <th>Restrictions</th>
  9411. <th>Description</th>
  9412. </tr>
  9413. </thead>
  9414. <tbody>
  9415. <tr>
  9416. <td>» _id</td>
  9417. <td>string</td>
  9418. <td>false</td>
  9419. <td>none</td>
  9420. <td>none</td>
  9421. </tr>
  9422. <tr>
  9423. <td>» customFields</td>
  9424. <td>object</td>
  9425. <td>false</td>
  9426. <td>none</td>
  9427. <td>none</td>
  9428. </tr>
  9429. </tbody>
  9430. </table>
  9431. <aside class="warning">
  9432. To perform this operation, you must be authenticated by means of one of the following methods:
  9433. UserSecurity
  9434. </aside>
  9435. <h2 id="get_list_cards_count">get_list_cards_count</h2>
  9436. <p><a id="opIdget_list_cards_count"></a></p>
  9437. <blockquote>
  9438. <p>Code samples</p>
  9439. </blockquote>
  9440. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  9441. curl -X GET /api/boards/{board}/lists/{list}/cards_count \
  9442. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  9443. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  9444. </code></pre>
  9445. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/lists/{list}/cards_count</span> <span class="hljs-meta">HTTP/1.1</span>
  9446. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  9447. </span></code></pre>
  9448. <pre class="highlight tab tab-javascript"><code>
  9449. <span class="hljs-keyword">const</span> headers = {
  9450. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  9451. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9452. };
  9453. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards_count&#x27;</span>,
  9454. {
  9455. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  9456. <span class="hljs-attr">headers</span>: headers
  9457. })
  9458. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  9459. <span class="hljs-keyword">return</span> res.json();
  9460. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  9461. <span class="hljs-built_in">console</span>.log(body);
  9462. });
  9463. </code></pre>
  9464. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  9465. <span class="hljs-keyword">const</span> headers = {
  9466. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  9467. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9468. };
  9469. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards_count&#x27;</span>,
  9470. {
  9471. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  9472. <span class="hljs-attr">headers</span>: headers
  9473. })
  9474. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  9475. <span class="hljs-keyword">return</span> res.json();
  9476. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  9477. <span class="hljs-built_in">console</span>.log(body);
  9478. });
  9479. </code></pre>
  9480. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  9481. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  9482. headers = {
  9483. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  9484. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9485. }
  9486. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards_count&#x27;</span>,
  9487. <span class="hljs-symbol">params:</span> {
  9488. }, <span class="hljs-symbol">headers:</span> headers
  9489. p JSON.parse(result)
  9490. </code></pre>
  9491. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  9492. headers = {
  9493. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  9494. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9495. }
  9496. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards_count&#x27;</span>, headers = headers)
  9497. <span class="hljs-built_in">print</span>(r.json())
  9498. </code></pre>
  9499. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/lists/{list}/cards_count&quot;</span>);
  9500. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  9501. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  9502. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  9503. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  9504. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  9505. String inputLine;
  9506. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  9507. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  9508. response.append(inputLine);
  9509. }
  9510. in.close();
  9511. System.out.println(response.toString());
  9512. </code></pre>
  9513. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  9514. <span class="hljs-keyword">import</span> (
  9515. <span class="hljs-string">&quot;bytes&quot;</span>
  9516. <span class="hljs-string">&quot;net/http&quot;</span>
  9517. )
  9518. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  9519. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  9520. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  9521. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  9522. }
  9523. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  9524. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/lists/{list}/cards_count&quot;</span>, data)
  9525. req.Header = headers
  9526. client := &amp;http.Client{}
  9527. resp, err := client.Do(req)
  9528. <span class="hljs-comment">// ...</span>
  9529. }
  9530. </code></pre>
  9531. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  9532. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  9533. );
  9534. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  9535. <span class="hljs-comment">// Define array of request body.</span>
  9536. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  9537. <span class="hljs-keyword">try</span> {
  9538. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}/cards_count&#x27;</span>, <span class="hljs-keyword">array</span>(
  9539. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  9540. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  9541. )
  9542. );
  9543. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  9544. }
  9545. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  9546. <span class="hljs-comment">// handle exception or api errors.</span>
  9547. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  9548. }
  9549. <span class="hljs-comment">// ...</span>
  9550. </code></pre>
  9551. <p><code>GET /api/boards/{board}/lists/{list}/cards_count</code></p>
  9552. <p><em>Get a cards count to a list</em></p>
  9553. <h3 id="get_list_cards_count-parameters">Parameters</h3>
  9554. <table>
  9555. <thead>
  9556. <tr>
  9557. <th>Name</th>
  9558. <th>In</th>
  9559. <th>Type</th>
  9560. <th>Required</th>
  9561. <th>Description</th>
  9562. </tr>
  9563. </thead>
  9564. <tbody>
  9565. <tr>
  9566. <td>board</td>
  9567. <td>path</td>
  9568. <td>string</td>
  9569. <td>true</td>
  9570. <td>the board ID</td>
  9571. </tr>
  9572. <tr>
  9573. <td>list</td>
  9574. <td>path</td>
  9575. <td>string</td>
  9576. <td>true</td>
  9577. <td>the List ID</td>
  9578. </tr>
  9579. </tbody>
  9580. </table>
  9581. <h4 id="detailed-descriptions-29">Detailed descriptions</h4>
  9582. <p><strong>board</strong>: the board ID</p>
  9583. <p><strong>list</strong>: the List ID</p>
  9584. <blockquote>
  9585. <p>Example responses</p>
  9586. </blockquote>
  9587. <blockquote>
  9588. <p>200 Response</p>
  9589. </blockquote>
  9590. <pre class="highlight tab tab-json"><code>{
  9591. <span class="hljs-attr">&quot;list_cards_count&quot;</span>: <span class="hljs-number">0</span>
  9592. }
  9593. </code></pre>
  9594. <h3 id="get_list_cards_count-responses">Responses</h3>
  9595. <table>
  9596. <thead>
  9597. <tr>
  9598. <th>Status</th>
  9599. <th>Meaning</th>
  9600. <th>Description</th>
  9601. <th>Schema</th>
  9602. </tr>
  9603. </thead>
  9604. <tbody>
  9605. <tr>
  9606. <td>200</td>
  9607. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  9608. <td>200 response</td>
  9609. <td>Inline</td>
  9610. </tr>
  9611. </tbody>
  9612. </table>
  9613. <h3 id="get_list_cards_count-responseschema">Response Schema</h3>
  9614. <p>Status Code <strong>200</strong></p>
  9615. <table>
  9616. <thead>
  9617. <tr>
  9618. <th>Name</th>
  9619. <th>Type</th>
  9620. <th>Required</th>
  9621. <th>Restrictions</th>
  9622. <th>Description</th>
  9623. </tr>
  9624. </thead>
  9625. <tbody>
  9626. <tr>
  9627. <td>» list_cards_count</td>
  9628. <td>integer</td>
  9629. <td>false</td>
  9630. <td>none</td>
  9631. <td>none</td>
  9632. </tr>
  9633. </tbody>
  9634. </table>
  9635. <aside class="warning">
  9636. To perform this operation, you must be authenticated by means of one of the following methods:
  9637. UserSecurity
  9638. </aside>
  9639. <h2 id="get_swimlane_cards">get_swimlane_cards</h2>
  9640. <p><a id="opIdget_swimlane_cards"></a></p>
  9641. <blockquote>
  9642. <p>Code samples</p>
  9643. </blockquote>
  9644. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  9645. curl -X GET /api/boards/{board}/swimlanes/{swimlane}/cards \
  9646. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  9647. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  9648. </code></pre>
  9649. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/swimlanes/{swimlane}/cards</span> <span class="hljs-meta">HTTP/1.1</span>
  9650. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  9651. </span></code></pre>
  9652. <pre class="highlight tab tab-javascript"><code>
  9653. <span class="hljs-keyword">const</span> headers = {
  9654. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  9655. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9656. };
  9657. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}/cards&#x27;</span>,
  9658. {
  9659. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  9660. <span class="hljs-attr">headers</span>: headers
  9661. })
  9662. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  9663. <span class="hljs-keyword">return</span> res.json();
  9664. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  9665. <span class="hljs-built_in">console</span>.log(body);
  9666. });
  9667. </code></pre>
  9668. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  9669. <span class="hljs-keyword">const</span> headers = {
  9670. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  9671. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9672. };
  9673. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}/cards&#x27;</span>,
  9674. {
  9675. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  9676. <span class="hljs-attr">headers</span>: headers
  9677. })
  9678. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  9679. <span class="hljs-keyword">return</span> res.json();
  9680. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  9681. <span class="hljs-built_in">console</span>.log(body);
  9682. });
  9683. </code></pre>
  9684. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  9685. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  9686. headers = {
  9687. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  9688. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9689. }
  9690. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}/cards&#x27;</span>,
  9691. <span class="hljs-symbol">params:</span> {
  9692. }, <span class="hljs-symbol">headers:</span> headers
  9693. p JSON.parse(result)
  9694. </code></pre>
  9695. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  9696. headers = {
  9697. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  9698. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9699. }
  9700. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}/cards&#x27;</span>, headers = headers)
  9701. <span class="hljs-built_in">print</span>(r.json())
  9702. </code></pre>
  9703. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/swimlanes/{swimlane}/cards&quot;</span>);
  9704. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  9705. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  9706. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  9707. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  9708. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  9709. String inputLine;
  9710. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  9711. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  9712. response.append(inputLine);
  9713. }
  9714. in.close();
  9715. System.out.println(response.toString());
  9716. </code></pre>
  9717. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  9718. <span class="hljs-keyword">import</span> (
  9719. <span class="hljs-string">&quot;bytes&quot;</span>
  9720. <span class="hljs-string">&quot;net/http&quot;</span>
  9721. )
  9722. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  9723. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  9724. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  9725. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  9726. }
  9727. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  9728. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/swimlanes/{swimlane}/cards&quot;</span>, data)
  9729. req.Header = headers
  9730. client := &amp;http.Client{}
  9731. resp, err := client.Do(req)
  9732. <span class="hljs-comment">// ...</span>
  9733. }
  9734. </code></pre>
  9735. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  9736. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  9737. );
  9738. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  9739. <span class="hljs-comment">// Define array of request body.</span>
  9740. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  9741. <span class="hljs-keyword">try</span> {
  9742. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}/cards&#x27;</span>, <span class="hljs-keyword">array</span>(
  9743. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  9744. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  9745. )
  9746. );
  9747. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  9748. }
  9749. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  9750. <span class="hljs-comment">// handle exception or api errors.</span>
  9751. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  9752. }
  9753. <span class="hljs-comment">// ...</span>
  9754. </code></pre>
  9755. <p><code>GET /api/boards/{board}/swimlanes/{swimlane}/cards</code></p>
  9756. <p><em>get all cards attached to a swimlane</em></p>
  9757. <h3 id="get_swimlane_cards-parameters">Parameters</h3>
  9758. <table>
  9759. <thead>
  9760. <tr>
  9761. <th>Name</th>
  9762. <th>In</th>
  9763. <th>Type</th>
  9764. <th>Required</th>
  9765. <th>Description</th>
  9766. </tr>
  9767. </thead>
  9768. <tbody>
  9769. <tr>
  9770. <td>board</td>
  9771. <td>path</td>
  9772. <td>string</td>
  9773. <td>true</td>
  9774. <td>the board ID</td>
  9775. </tr>
  9776. <tr>
  9777. <td>swimlane</td>
  9778. <td>path</td>
  9779. <td>string</td>
  9780. <td>true</td>
  9781. <td>the swimlane ID</td>
  9782. </tr>
  9783. </tbody>
  9784. </table>
  9785. <h4 id="detailed-descriptions-30">Detailed descriptions</h4>
  9786. <p><strong>board</strong>: the board ID</p>
  9787. <p><strong>swimlane</strong>: the swimlane ID</p>
  9788. <blockquote>
  9789. <p>Example responses</p>
  9790. </blockquote>
  9791. <blockquote>
  9792. <p>200 Response</p>
  9793. </blockquote>
  9794. <pre class="highlight tab tab-json"><code>[
  9795. {
  9796. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  9797. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  9798. <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  9799. <span class="hljs-attr">&quot;listId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  9800. }
  9801. ]
  9802. </code></pre>
  9803. <h3 id="get_swimlane_cards-responses">Responses</h3>
  9804. <table>
  9805. <thead>
  9806. <tr>
  9807. <th>Status</th>
  9808. <th>Meaning</th>
  9809. <th>Description</th>
  9810. <th>Schema</th>
  9811. </tr>
  9812. </thead>
  9813. <tbody>
  9814. <tr>
  9815. <td>200</td>
  9816. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  9817. <td>200 response</td>
  9818. <td>Inline</td>
  9819. </tr>
  9820. </tbody>
  9821. </table>
  9822. <h3 id="get_swimlane_cards-responseschema">Response Schema</h3>
  9823. <p>Status Code <strong>200</strong></p>
  9824. <table>
  9825. <thead>
  9826. <tr>
  9827. <th>Name</th>
  9828. <th>Type</th>
  9829. <th>Required</th>
  9830. <th>Restrictions</th>
  9831. <th>Description</th>
  9832. </tr>
  9833. </thead>
  9834. <tbody>
  9835. <tr>
  9836. <td>» _id</td>
  9837. <td>string</td>
  9838. <td>false</td>
  9839. <td>none</td>
  9840. <td>none</td>
  9841. </tr>
  9842. <tr>
  9843. <td>» title</td>
  9844. <td>string</td>
  9845. <td>false</td>
  9846. <td>none</td>
  9847. <td>none</td>
  9848. </tr>
  9849. <tr>
  9850. <td>» description</td>
  9851. <td>string</td>
  9852. <td>false</td>
  9853. <td>none</td>
  9854. <td>none</td>
  9855. </tr>
  9856. <tr>
  9857. <td>» listId</td>
  9858. <td>string</td>
  9859. <td>false</td>
  9860. <td>none</td>
  9861. <td>none</td>
  9862. </tr>
  9863. </tbody>
  9864. </table>
  9865. <aside class="warning">
  9866. To perform this operation, you must be authenticated by means of one of the following methods:
  9867. UserSecurity
  9868. </aside>
  9869. <h1 id="wekan-rest-api-customfields">CustomFields</h1>
  9870. <h2 id="get_all_custom_fields">get_all_custom_fields</h2>
  9871. <p><a id="opIdget_all_custom_fields"></a></p>
  9872. <blockquote>
  9873. <p>Code samples</p>
  9874. </blockquote>
  9875. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  9876. curl -X GET /api/boards/{board}/custom-fields \
  9877. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  9878. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  9879. </code></pre>
  9880. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/custom-fields</span> <span class="hljs-meta">HTTP/1.1</span>
  9881. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  9882. </span></code></pre>
  9883. <pre class="highlight tab tab-javascript"><code>
  9884. <span class="hljs-keyword">const</span> headers = {
  9885. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  9886. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9887. };
  9888. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields&#x27;</span>,
  9889. {
  9890. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  9891. <span class="hljs-attr">headers</span>: headers
  9892. })
  9893. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  9894. <span class="hljs-keyword">return</span> res.json();
  9895. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  9896. <span class="hljs-built_in">console</span>.log(body);
  9897. });
  9898. </code></pre>
  9899. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  9900. <span class="hljs-keyword">const</span> headers = {
  9901. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  9902. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9903. };
  9904. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields&#x27;</span>,
  9905. {
  9906. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  9907. <span class="hljs-attr">headers</span>: headers
  9908. })
  9909. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  9910. <span class="hljs-keyword">return</span> res.json();
  9911. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  9912. <span class="hljs-built_in">console</span>.log(body);
  9913. });
  9914. </code></pre>
  9915. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  9916. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  9917. headers = {
  9918. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  9919. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9920. }
  9921. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/custom-fields&#x27;</span>,
  9922. <span class="hljs-symbol">params:</span> {
  9923. }, <span class="hljs-symbol">headers:</span> headers
  9924. p JSON.parse(result)
  9925. </code></pre>
  9926. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  9927. headers = {
  9928. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  9929. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  9930. }
  9931. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields&#x27;</span>, headers = headers)
  9932. <span class="hljs-built_in">print</span>(r.json())
  9933. </code></pre>
  9934. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/custom-fields&quot;</span>);
  9935. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  9936. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  9937. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  9938. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  9939. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  9940. String inputLine;
  9941. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  9942. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  9943. response.append(inputLine);
  9944. }
  9945. in.close();
  9946. System.out.println(response.toString());
  9947. </code></pre>
  9948. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  9949. <span class="hljs-keyword">import</span> (
  9950. <span class="hljs-string">&quot;bytes&quot;</span>
  9951. <span class="hljs-string">&quot;net/http&quot;</span>
  9952. )
  9953. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  9954. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  9955. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  9956. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  9957. }
  9958. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  9959. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/custom-fields&quot;</span>, data)
  9960. req.Header = headers
  9961. client := &amp;http.Client{}
  9962. resp, err := client.Do(req)
  9963. <span class="hljs-comment">// ...</span>
  9964. }
  9965. </code></pre>
  9966. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  9967. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  9968. );
  9969. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  9970. <span class="hljs-comment">// Define array of request body.</span>
  9971. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  9972. <span class="hljs-keyword">try</span> {
  9973. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields&#x27;</span>, <span class="hljs-keyword">array</span>(
  9974. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  9975. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  9976. )
  9977. );
  9978. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  9979. }
  9980. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  9981. <span class="hljs-comment">// handle exception or api errors.</span>
  9982. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  9983. }
  9984. <span class="hljs-comment">// ...</span>
  9985. </code></pre>
  9986. <p><code>GET /api/boards/{board}/custom-fields</code></p>
  9987. <p><em>Get the list of Custom Fields attached to a board</em></p>
  9988. <h3 id="get_all_custom_fields-parameters">Parameters</h3>
  9989. <table>
  9990. <thead>
  9991. <tr>
  9992. <th>Name</th>
  9993. <th>In</th>
  9994. <th>Type</th>
  9995. <th>Required</th>
  9996. <th>Description</th>
  9997. </tr>
  9998. </thead>
  9999. <tbody>
  10000. <tr>
  10001. <td>board</td>
  10002. <td>path</td>
  10003. <td>string</td>
  10004. <td>true</td>
  10005. <td>the board value</td>
  10006. </tr>
  10007. </tbody>
  10008. </table>
  10009. <blockquote>
  10010. <p>Example responses</p>
  10011. </blockquote>
  10012. <blockquote>
  10013. <p>200 Response</p>
  10014. </blockquote>
  10015. <pre class="highlight tab tab-json"><code>[
  10016. {
  10017. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  10018. <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  10019. <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  10020. }
  10021. ]
  10022. </code></pre>
  10023. <h3 id="get_all_custom_fields-responses">Responses</h3>
  10024. <table>
  10025. <thead>
  10026. <tr>
  10027. <th>Status</th>
  10028. <th>Meaning</th>
  10029. <th>Description</th>
  10030. <th>Schema</th>
  10031. </tr>
  10032. </thead>
  10033. <tbody>
  10034. <tr>
  10035. <td>200</td>
  10036. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  10037. <td>200 response</td>
  10038. <td>Inline</td>
  10039. </tr>
  10040. </tbody>
  10041. </table>
  10042. <h3 id="get_all_custom_fields-responseschema">Response Schema</h3>
  10043. <p>Status Code <strong>200</strong></p>
  10044. <table>
  10045. <thead>
  10046. <tr>
  10047. <th>Name</th>
  10048. <th>Type</th>
  10049. <th>Required</th>
  10050. <th>Restrictions</th>
  10051. <th>Description</th>
  10052. </tr>
  10053. </thead>
  10054. <tbody>
  10055. <tr>
  10056. <td>» _id</td>
  10057. <td>string</td>
  10058. <td>false</td>
  10059. <td>none</td>
  10060. <td>none</td>
  10061. </tr>
  10062. <tr>
  10063. <td>» name</td>
  10064. <td>string</td>
  10065. <td>false</td>
  10066. <td>none</td>
  10067. <td>none</td>
  10068. </tr>
  10069. <tr>
  10070. <td>» type</td>
  10071. <td>string</td>
  10072. <td>false</td>
  10073. <td>none</td>
  10074. <td>none</td>
  10075. </tr>
  10076. </tbody>
  10077. </table>
  10078. <aside class="warning">
  10079. To perform this operation, you must be authenticated by means of one of the following methods:
  10080. UserSecurity
  10081. </aside>
  10082. <h2 id="new_custom_field">new_custom_field</h2>
  10083. <p><a id="opIdnew_custom_field"></a></p>
  10084. <blockquote>
  10085. <p>Code samples</p>
  10086. </blockquote>
  10087. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  10088. curl -X POST /api/boards/{board}/custom-fields \
  10089. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  10090. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  10091. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  10092. </code></pre>
  10093. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/boards/{board}/custom-fields</span> <span class="hljs-meta">HTTP/1.1</span>
  10094. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  10095. Accept: application/json
  10096. </span></code></pre>
  10097. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  10098. &quot;name&quot;: &quot;string&quot;,
  10099. &quot;type&quot;: &quot;string&quot;,
  10100. &quot;settings&quot;: &quot;string&quot;,
  10101. &quot;showOnCard&quot;: true,
  10102. &quot;automaticallyOnCard&quot;: true,
  10103. &quot;showLabelOnMiniCard&quot;: true,
  10104. &quot;showSumAtTopOfList&quot;: true,
  10105. &quot;authorId&quot;: &quot;string&quot;
  10106. }&#x27;</span>;
  10107. <span class="hljs-keyword">const</span> headers = {
  10108. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  10109. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  10110. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  10111. };
  10112. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields&#x27;</span>,
  10113. {
  10114. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  10115. <span class="hljs-attr">body</span>: inputBody,
  10116. <span class="hljs-attr">headers</span>: headers
  10117. })
  10118. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  10119. <span class="hljs-keyword">return</span> res.json();
  10120. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  10121. <span class="hljs-built_in">console</span>.log(body);
  10122. });
  10123. </code></pre>
  10124. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  10125. <span class="hljs-keyword">const</span> inputBody = {
  10126. <span class="hljs-string">&quot;name&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  10127. <span class="hljs-string">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  10128. <span class="hljs-string">&quot;settings&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  10129. <span class="hljs-string">&quot;showOnCard&quot;</span>: <span class="hljs-literal">true</span>,
  10130. <span class="hljs-string">&quot;automaticallyOnCard&quot;</span>: <span class="hljs-literal">true</span>,
  10131. <span class="hljs-string">&quot;showLabelOnMiniCard&quot;</span>: <span class="hljs-literal">true</span>,
  10132. <span class="hljs-string">&quot;showSumAtTopOfList&quot;</span>: <span class="hljs-literal">true</span>,
  10133. <span class="hljs-string">&quot;authorId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  10134. };
  10135. <span class="hljs-keyword">const</span> headers = {
  10136. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  10137. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  10138. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  10139. };
  10140. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields&#x27;</span>,
  10141. {
  10142. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  10143. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  10144. <span class="hljs-attr">headers</span>: headers
  10145. })
  10146. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  10147. <span class="hljs-keyword">return</span> res.json();
  10148. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  10149. <span class="hljs-built_in">console</span>.log(body);
  10150. });
  10151. </code></pre>
  10152. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  10153. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  10154. headers = {
  10155. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  10156. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  10157. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  10158. }
  10159. result = RestClient.post <span class="hljs-string">&#x27;/api/boards/{board}/custom-fields&#x27;</span>,
  10160. <span class="hljs-symbol">params:</span> {
  10161. }, <span class="hljs-symbol">headers:</span> headers
  10162. p JSON.parse(result)
  10163. </code></pre>
  10164. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  10165. headers = {
  10166. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  10167. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  10168. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  10169. }
  10170. r = requests.post(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields&#x27;</span>, headers = headers)
  10171. <span class="hljs-built_in">print</span>(r.json())
  10172. </code></pre>
  10173. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/custom-fields&quot;</span>);
  10174. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  10175. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  10176. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  10177. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  10178. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  10179. String inputLine;
  10180. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  10181. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  10182. response.append(inputLine);
  10183. }
  10184. in.close();
  10185. System.out.println(response.toString());
  10186. </code></pre>
  10187. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  10188. <span class="hljs-keyword">import</span> (
  10189. <span class="hljs-string">&quot;bytes&quot;</span>
  10190. <span class="hljs-string">&quot;net/http&quot;</span>
  10191. )
  10192. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  10193. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  10194. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  10195. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  10196. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  10197. }
  10198. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  10199. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/custom-fields&quot;</span>, data)
  10200. req.Header = headers
  10201. client := &amp;http.Client{}
  10202. resp, err := client.Do(req)
  10203. <span class="hljs-comment">// ...</span>
  10204. }
  10205. </code></pre>
  10206. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  10207. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  10208. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  10209. );
  10210. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  10211. <span class="hljs-comment">// Define array of request body.</span>
  10212. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  10213. <span class="hljs-keyword">try</span> {
  10214. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields&#x27;</span>, <span class="hljs-keyword">array</span>(
  10215. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  10216. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  10217. )
  10218. );
  10219. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  10220. }
  10221. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  10222. <span class="hljs-comment">// handle exception or api errors.</span>
  10223. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  10224. }
  10225. <span class="hljs-comment">// ...</span>
  10226. </code></pre>
  10227. <p><code>POST /api/boards/{board}/custom-fields</code></p>
  10228. <p><em>Create a Custom Field</em></p>
  10229. <blockquote>
  10230. <p>Body parameter</p>
  10231. </blockquote>
  10232. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">name:</span> <span class="hljs-string">string</span>
  10233. <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>
  10234. <span class="hljs-attr">settings:</span> <span class="hljs-string">string</span>
  10235. <span class="hljs-attr">showOnCard:</span> <span class="hljs-literal">true</span>
  10236. <span class="hljs-attr">automaticallyOnCard:</span> <span class="hljs-literal">true</span>
  10237. <span class="hljs-attr">showLabelOnMiniCard:</span> <span class="hljs-literal">true</span>
  10238. <span class="hljs-attr">showSumAtTopOfList:</span> <span class="hljs-literal">true</span>
  10239. <span class="hljs-attr">authorId:</span> <span class="hljs-string">string</span>
  10240. </code></pre>
  10241. <h3 id="new_custom_field-parameters">Parameters</h3>
  10242. <table>
  10243. <thead>
  10244. <tr>
  10245. <th>Name</th>
  10246. <th>In</th>
  10247. <th>Type</th>
  10248. <th>Required</th>
  10249. <th>Description</th>
  10250. </tr>
  10251. </thead>
  10252. <tbody>
  10253. <tr>
  10254. <td>board</td>
  10255. <td>path</td>
  10256. <td>string</td>
  10257. <td>true</td>
  10258. <td>the board value</td>
  10259. </tr>
  10260. <tr>
  10261. <td>body</td>
  10262. <td>body</td>
  10263. <td>object</td>
  10264. <td>true</td>
  10265. <td>none</td>
  10266. </tr>
  10267. <tr>
  10268. <td>» name</td>
  10269. <td>body</td>
  10270. <td>string</td>
  10271. <td>true</td>
  10272. <td>the name of the custom field</td>
  10273. </tr>
  10274. <tr>
  10275. <td>» type</td>
  10276. <td>body</td>
  10277. <td>string</td>
  10278. <td>true</td>
  10279. <td>the type of the custom field</td>
  10280. </tr>
  10281. <tr>
  10282. <td>» settings</td>
  10283. <td>body</td>
  10284. <td>string</td>
  10285. <td>true</td>
  10286. <td>the settings object of the custom field</td>
  10287. </tr>
  10288. <tr>
  10289. <td>» showOnCard</td>
  10290. <td>body</td>
  10291. <td>boolean</td>
  10292. <td>true</td>
  10293. <td>should we show the custom field on cards?</td>
  10294. </tr>
  10295. <tr>
  10296. <td>» automaticallyOnCard</td>
  10297. <td>body</td>
  10298. <td>boolean</td>
  10299. <td>true</td>
  10300. <td>should the custom fields automatically be added on cards?</td>
  10301. </tr>
  10302. <tr>
  10303. <td>» showLabelOnMiniCard</td>
  10304. <td>body</td>
  10305. <td>boolean</td>
  10306. <td>true</td>
  10307. <td>should the label of the custom field be shown on minicards?</td>
  10308. </tr>
  10309. <tr>
  10310. <td>» showSumAtTopOfList</td>
  10311. <td>body</td>
  10312. <td>boolean</td>
  10313. <td>true</td>
  10314. <td>should the sum of the custom fields be shown at top of list?</td>
  10315. </tr>
  10316. <tr>
  10317. <td>» authorId</td>
  10318. <td>body</td>
  10319. <td>string</td>
  10320. <td>true</td>
  10321. <td>the authorId value</td>
  10322. </tr>
  10323. </tbody>
  10324. </table>
  10325. <blockquote>
  10326. <p>Example responses</p>
  10327. </blockquote>
  10328. <blockquote>
  10329. <p>200 Response</p>
  10330. </blockquote>
  10331. <pre class="highlight tab tab-json"><code>{
  10332. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  10333. }
  10334. </code></pre>
  10335. <h3 id="new_custom_field-responses">Responses</h3>
  10336. <table>
  10337. <thead>
  10338. <tr>
  10339. <th>Status</th>
  10340. <th>Meaning</th>
  10341. <th>Description</th>
  10342. <th>Schema</th>
  10343. </tr>
  10344. </thead>
  10345. <tbody>
  10346. <tr>
  10347. <td>200</td>
  10348. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  10349. <td>200 response</td>
  10350. <td>Inline</td>
  10351. </tr>
  10352. </tbody>
  10353. </table>
  10354. <h3 id="new_custom_field-responseschema">Response Schema</h3>
  10355. <p>Status Code <strong>200</strong></p>
  10356. <table>
  10357. <thead>
  10358. <tr>
  10359. <th>Name</th>
  10360. <th>Type</th>
  10361. <th>Required</th>
  10362. <th>Restrictions</th>
  10363. <th>Description</th>
  10364. </tr>
  10365. </thead>
  10366. <tbody>
  10367. <tr>
  10368. <td>» _id</td>
  10369. <td>string</td>
  10370. <td>false</td>
  10371. <td>none</td>
  10372. <td>none</td>
  10373. </tr>
  10374. </tbody>
  10375. </table>
  10376. <aside class="warning">
  10377. To perform this operation, you must be authenticated by means of one of the following methods:
  10378. UserSecurity
  10379. </aside>
  10380. <h2 id="get_custom_field">get_custom_field</h2>
  10381. <p><a id="opIdget_custom_field"></a></p>
  10382. <blockquote>
  10383. <p>Code samples</p>
  10384. </blockquote>
  10385. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  10386. curl -X GET /api/boards/{board}/custom-fields/{customField} \
  10387. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  10388. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  10389. </code></pre>
  10390. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/custom-fields/{customField}</span> <span class="hljs-meta">HTTP/1.1</span>
  10391. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  10392. </span></code></pre>
  10393. <pre class="highlight tab tab-javascript"><code>
  10394. <span class="hljs-keyword">const</span> headers = {
  10395. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  10396. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  10397. };
  10398. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}&#x27;</span>,
  10399. {
  10400. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  10401. <span class="hljs-attr">headers</span>: headers
  10402. })
  10403. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  10404. <span class="hljs-keyword">return</span> res.json();
  10405. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  10406. <span class="hljs-built_in">console</span>.log(body);
  10407. });
  10408. </code></pre>
  10409. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  10410. <span class="hljs-keyword">const</span> headers = {
  10411. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  10412. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  10413. };
  10414. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}&#x27;</span>,
  10415. {
  10416. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  10417. <span class="hljs-attr">headers</span>: headers
  10418. })
  10419. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  10420. <span class="hljs-keyword">return</span> res.json();
  10421. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  10422. <span class="hljs-built_in">console</span>.log(body);
  10423. });
  10424. </code></pre>
  10425. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  10426. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  10427. headers = {
  10428. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  10429. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  10430. }
  10431. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}&#x27;</span>,
  10432. <span class="hljs-symbol">params:</span> {
  10433. }, <span class="hljs-symbol">headers:</span> headers
  10434. p JSON.parse(result)
  10435. </code></pre>
  10436. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  10437. headers = {
  10438. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  10439. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  10440. }
  10441. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}&#x27;</span>, headers = headers)
  10442. <span class="hljs-built_in">print</span>(r.json())
  10443. </code></pre>
  10444. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/custom-fields/{customField}&quot;</span>);
  10445. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  10446. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  10447. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  10448. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  10449. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  10450. String inputLine;
  10451. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  10452. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  10453. response.append(inputLine);
  10454. }
  10455. in.close();
  10456. System.out.println(response.toString());
  10457. </code></pre>
  10458. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  10459. <span class="hljs-keyword">import</span> (
  10460. <span class="hljs-string">&quot;bytes&quot;</span>
  10461. <span class="hljs-string">&quot;net/http&quot;</span>
  10462. )
  10463. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  10464. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  10465. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  10466. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  10467. }
  10468. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  10469. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/custom-fields/{customField}&quot;</span>, data)
  10470. req.Header = headers
  10471. client := &amp;http.Client{}
  10472. resp, err := client.Do(req)
  10473. <span class="hljs-comment">// ...</span>
  10474. }
  10475. </code></pre>
  10476. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  10477. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  10478. );
  10479. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  10480. <span class="hljs-comment">// Define array of request body.</span>
  10481. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  10482. <span class="hljs-keyword">try</span> {
  10483. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}&#x27;</span>, <span class="hljs-keyword">array</span>(
  10484. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  10485. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  10486. )
  10487. );
  10488. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  10489. }
  10490. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  10491. <span class="hljs-comment">// handle exception or api errors.</span>
  10492. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  10493. }
  10494. <span class="hljs-comment">// ...</span>
  10495. </code></pre>
  10496. <p><code>GET /api/boards/{board}/custom-fields/{customField}</code></p>
  10497. <p><em>Get a Custom Fields attached to a board</em></p>
  10498. <h3 id="get_custom_field-parameters">Parameters</h3>
  10499. <table>
  10500. <thead>
  10501. <tr>
  10502. <th>Name</th>
  10503. <th>In</th>
  10504. <th>Type</th>
  10505. <th>Required</th>
  10506. <th>Description</th>
  10507. </tr>
  10508. </thead>
  10509. <tbody>
  10510. <tr>
  10511. <td>board</td>
  10512. <td>path</td>
  10513. <td>string</td>
  10514. <td>true</td>
  10515. <td>the board value</td>
  10516. </tr>
  10517. <tr>
  10518. <td>customField</td>
  10519. <td>path</td>
  10520. <td>string</td>
  10521. <td>true</td>
  10522. <td>the ID of the custom field</td>
  10523. </tr>
  10524. </tbody>
  10525. </table>
  10526. <h4 id="detailed-descriptions-31">Detailed descriptions</h4>
  10527. <p><strong>customField</strong>: the ID of the custom field</p>
  10528. <blockquote>
  10529. <p>Example responses</p>
  10530. </blockquote>
  10531. <blockquote>
  10532. <p>200 Response</p>
  10533. </blockquote>
  10534. <pre class="highlight tab tab-json"><code>[
  10535. {
  10536. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  10537. <span class="hljs-attr">&quot;boardIds&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  10538. }
  10539. ]
  10540. </code></pre>
  10541. <h3 id="get_custom_field-responses">Responses</h3>
  10542. <table>
  10543. <thead>
  10544. <tr>
  10545. <th>Status</th>
  10546. <th>Meaning</th>
  10547. <th>Description</th>
  10548. <th>Schema</th>
  10549. </tr>
  10550. </thead>
  10551. <tbody>
  10552. <tr>
  10553. <td>200</td>
  10554. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  10555. <td>200 response</td>
  10556. <td>Inline</td>
  10557. </tr>
  10558. </tbody>
  10559. </table>
  10560. <h3 id="get_custom_field-responseschema">Response Schema</h3>
  10561. <p>Status Code <strong>200</strong></p>
  10562. <table>
  10563. <thead>
  10564. <tr>
  10565. <th>Name</th>
  10566. <th>Type</th>
  10567. <th>Required</th>
  10568. <th>Restrictions</th>
  10569. <th>Description</th>
  10570. </tr>
  10571. </thead>
  10572. <tbody>
  10573. <tr>
  10574. <td>» _id</td>
  10575. <td>string</td>
  10576. <td>false</td>
  10577. <td>none</td>
  10578. <td>none</td>
  10579. </tr>
  10580. <tr>
  10581. <td>» boardIds</td>
  10582. <td>string</td>
  10583. <td>false</td>
  10584. <td>none</td>
  10585. <td>none</td>
  10586. </tr>
  10587. </tbody>
  10588. </table>
  10589. <aside class="warning">
  10590. To perform this operation, you must be authenticated by means of one of the following methods:
  10591. UserSecurity
  10592. </aside>
  10593. <h2 id="edit_custom_field">edit_custom_field</h2>
  10594. <p><a id="opIdedit_custom_field"></a></p>
  10595. <blockquote>
  10596. <p>Code samples</p>
  10597. </blockquote>
  10598. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  10599. curl -X PUT /api/boards/{board}/custom-fields/{customField} \
  10600. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  10601. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  10602. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  10603. </code></pre>
  10604. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">PUT</span> <span class="hljs-string">/api/boards/{board}/custom-fields/{customField}</span> <span class="hljs-meta">HTTP/1.1</span>
  10605. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  10606. Accept: application/json
  10607. </span></code></pre>
  10608. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  10609. &quot;name&quot;: &quot;string&quot;,
  10610. &quot;type&quot;: &quot;string&quot;,
  10611. &quot;settings&quot;: &quot;string&quot;,
  10612. &quot;showOnCard&quot;: true,
  10613. &quot;automaticallyOnCard&quot;: true,
  10614. &quot;alwaysOnCard&quot;: &quot;string&quot;,
  10615. &quot;showLabelOnMiniCard&quot;: true,
  10616. &quot;showSumAtTopOfList&quot;: true
  10617. }&#x27;</span>;
  10618. <span class="hljs-keyword">const</span> headers = {
  10619. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  10620. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  10621. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  10622. };
  10623. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}&#x27;</span>,
  10624. {
  10625. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;PUT&#x27;</span>,
  10626. <span class="hljs-attr">body</span>: inputBody,
  10627. <span class="hljs-attr">headers</span>: headers
  10628. })
  10629. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  10630. <span class="hljs-keyword">return</span> res.json();
  10631. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  10632. <span class="hljs-built_in">console</span>.log(body);
  10633. });
  10634. </code></pre>
  10635. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  10636. <span class="hljs-keyword">const</span> inputBody = {
  10637. <span class="hljs-string">&quot;name&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  10638. <span class="hljs-string">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  10639. <span class="hljs-string">&quot;settings&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  10640. <span class="hljs-string">&quot;showOnCard&quot;</span>: <span class="hljs-literal">true</span>,
  10641. <span class="hljs-string">&quot;automaticallyOnCard&quot;</span>: <span class="hljs-literal">true</span>,
  10642. <span class="hljs-string">&quot;alwaysOnCard&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  10643. <span class="hljs-string">&quot;showLabelOnMiniCard&quot;</span>: <span class="hljs-literal">true</span>,
  10644. <span class="hljs-string">&quot;showSumAtTopOfList&quot;</span>: <span class="hljs-literal">true</span>
  10645. };
  10646. <span class="hljs-keyword">const</span> headers = {
  10647. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  10648. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  10649. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  10650. };
  10651. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}&#x27;</span>,
  10652. {
  10653. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;PUT&#x27;</span>,
  10654. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  10655. <span class="hljs-attr">headers</span>: headers
  10656. })
  10657. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  10658. <span class="hljs-keyword">return</span> res.json();
  10659. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  10660. <span class="hljs-built_in">console</span>.log(body);
  10661. });
  10662. </code></pre>
  10663. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  10664. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  10665. headers = {
  10666. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  10667. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  10668. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  10669. }
  10670. result = RestClient.put <span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}&#x27;</span>,
  10671. <span class="hljs-symbol">params:</span> {
  10672. }, <span class="hljs-symbol">headers:</span> headers
  10673. p JSON.parse(result)
  10674. </code></pre>
  10675. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  10676. headers = {
  10677. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  10678. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  10679. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  10680. }
  10681. r = requests.put(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}&#x27;</span>, headers = headers)
  10682. <span class="hljs-built_in">print</span>(r.json())
  10683. </code></pre>
  10684. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/custom-fields/{customField}&quot;</span>);
  10685. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  10686. con.setRequestMethod(<span class="hljs-string">&quot;PUT&quot;</span>);
  10687. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  10688. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  10689. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  10690. String inputLine;
  10691. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  10692. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  10693. response.append(inputLine);
  10694. }
  10695. in.close();
  10696. System.out.println(response.toString());
  10697. </code></pre>
  10698. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  10699. <span class="hljs-keyword">import</span> (
  10700. <span class="hljs-string">&quot;bytes&quot;</span>
  10701. <span class="hljs-string">&quot;net/http&quot;</span>
  10702. )
  10703. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  10704. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  10705. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  10706. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  10707. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  10708. }
  10709. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  10710. req, err := http.NewRequest(<span class="hljs-string">&quot;PUT&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/custom-fields/{customField}&quot;</span>, data)
  10711. req.Header = headers
  10712. client := &amp;http.Client{}
  10713. resp, err := client.Do(req)
  10714. <span class="hljs-comment">// ...</span>
  10715. }
  10716. </code></pre>
  10717. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  10718. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  10719. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  10720. );
  10721. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  10722. <span class="hljs-comment">// Define array of request body.</span>
  10723. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  10724. <span class="hljs-keyword">try</span> {
  10725. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;PUT&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}&#x27;</span>, <span class="hljs-keyword">array</span>(
  10726. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  10727. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  10728. )
  10729. );
  10730. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  10731. }
  10732. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  10733. <span class="hljs-comment">// handle exception or api errors.</span>
  10734. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  10735. }
  10736. <span class="hljs-comment">// ...</span>
  10737. </code></pre>
  10738. <p><code>PUT /api/boards/{board}/custom-fields/{customField}</code></p>
  10739. <p><em>Update a Custom Field</em></p>
  10740. <blockquote>
  10741. <p>Body parameter</p>
  10742. </blockquote>
  10743. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">name:</span> <span class="hljs-string">string</span>
  10744. <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>
  10745. <span class="hljs-attr">settings:</span> <span class="hljs-string">string</span>
  10746. <span class="hljs-attr">showOnCard:</span> <span class="hljs-literal">true</span>
  10747. <span class="hljs-attr">automaticallyOnCard:</span> <span class="hljs-literal">true</span>
  10748. <span class="hljs-attr">alwaysOnCard:</span> <span class="hljs-string">string</span>
  10749. <span class="hljs-attr">showLabelOnMiniCard:</span> <span class="hljs-literal">true</span>
  10750. <span class="hljs-attr">showSumAtTopOfList:</span> <span class="hljs-literal">true</span>
  10751. </code></pre>
  10752. <h3 id="edit_custom_field-parameters">Parameters</h3>
  10753. <table>
  10754. <thead>
  10755. <tr>
  10756. <th>Name</th>
  10757. <th>In</th>
  10758. <th>Type</th>
  10759. <th>Required</th>
  10760. <th>Description</th>
  10761. </tr>
  10762. </thead>
  10763. <tbody>
  10764. <tr>
  10765. <td>board</td>
  10766. <td>path</td>
  10767. <td>string</td>
  10768. <td>true</td>
  10769. <td>the board value</td>
  10770. </tr>
  10771. <tr>
  10772. <td>customField</td>
  10773. <td>path</td>
  10774. <td>string</td>
  10775. <td>true</td>
  10776. <td>the customField value</td>
  10777. </tr>
  10778. <tr>
  10779. <td>body</td>
  10780. <td>body</td>
  10781. <td>object</td>
  10782. <td>true</td>
  10783. <td>none</td>
  10784. </tr>
  10785. <tr>
  10786. <td>» name</td>
  10787. <td>body</td>
  10788. <td>string</td>
  10789. <td>true</td>
  10790. <td>the name of the custom field</td>
  10791. </tr>
  10792. <tr>
  10793. <td>» type</td>
  10794. <td>body</td>
  10795. <td>string</td>
  10796. <td>true</td>
  10797. <td>the type of the custom field</td>
  10798. </tr>
  10799. <tr>
  10800. <td>» settings</td>
  10801. <td>body</td>
  10802. <td>string</td>
  10803. <td>true</td>
  10804. <td>the settings object of the custom field</td>
  10805. </tr>
  10806. <tr>
  10807. <td>» showOnCard</td>
  10808. <td>body</td>
  10809. <td>boolean</td>
  10810. <td>true</td>
  10811. <td>should we show the custom field on cards</td>
  10812. </tr>
  10813. <tr>
  10814. <td>» automaticallyOnCard</td>
  10815. <td>body</td>
  10816. <td>boolean</td>
  10817. <td>true</td>
  10818. <td>should the custom fields automatically be added on cards</td>
  10819. </tr>
  10820. <tr>
  10821. <td>» alwaysOnCard</td>
  10822. <td>body</td>
  10823. <td>string</td>
  10824. <td>true</td>
  10825. <td>the alwaysOnCard value</td>
  10826. </tr>
  10827. <tr>
  10828. <td>» showLabelOnMiniCard</td>
  10829. <td>body</td>
  10830. <td>boolean</td>
  10831. <td>true</td>
  10832. <td>should the label of the custom field be shown on minicards</td>
  10833. </tr>
  10834. <tr>
  10835. <td>» showSumAtTopOfList</td>
  10836. <td>body</td>
  10837. <td>boolean</td>
  10838. <td>true</td>
  10839. <td>should the sum of the custom fields be shown at top of list</td>
  10840. </tr>
  10841. </tbody>
  10842. </table>
  10843. <blockquote>
  10844. <p>Example responses</p>
  10845. </blockquote>
  10846. <blockquote>
  10847. <p>200 Response</p>
  10848. </blockquote>
  10849. <pre class="highlight tab tab-json"><code>{
  10850. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  10851. }
  10852. </code></pre>
  10853. <h3 id="edit_custom_field-responses">Responses</h3>
  10854. <table>
  10855. <thead>
  10856. <tr>
  10857. <th>Status</th>
  10858. <th>Meaning</th>
  10859. <th>Description</th>
  10860. <th>Schema</th>
  10861. </tr>
  10862. </thead>
  10863. <tbody>
  10864. <tr>
  10865. <td>200</td>
  10866. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  10867. <td>200 response</td>
  10868. <td>Inline</td>
  10869. </tr>
  10870. </tbody>
  10871. </table>
  10872. <h3 id="edit_custom_field-responseschema">Response Schema</h3>
  10873. <p>Status Code <strong>200</strong></p>
  10874. <table>
  10875. <thead>
  10876. <tr>
  10877. <th>Name</th>
  10878. <th>Type</th>
  10879. <th>Required</th>
  10880. <th>Restrictions</th>
  10881. <th>Description</th>
  10882. </tr>
  10883. </thead>
  10884. <tbody>
  10885. <tr>
  10886. <td>» _id</td>
  10887. <td>string</td>
  10888. <td>false</td>
  10889. <td>none</td>
  10890. <td>none</td>
  10891. </tr>
  10892. </tbody>
  10893. </table>
  10894. <aside class="warning">
  10895. To perform this operation, you must be authenticated by means of one of the following methods:
  10896. UserSecurity
  10897. </aside>
  10898. <h2 id="delete_custom_field">delete_custom_field</h2>
  10899. <p><a id="opIddelete_custom_field"></a></p>
  10900. <blockquote>
  10901. <p>Code samples</p>
  10902. </blockquote>
  10903. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  10904. curl -X DELETE /api/boards/{board}/custom-fields/{customField} \
  10905. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  10906. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  10907. </code></pre>
  10908. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">DELETE</span> <span class="hljs-string">/api/boards/{board}/custom-fields/{customField}</span> <span class="hljs-meta">HTTP/1.1</span>
  10909. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  10910. </span></code></pre>
  10911. <pre class="highlight tab tab-javascript"><code>
  10912. <span class="hljs-keyword">const</span> headers = {
  10913. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  10914. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  10915. };
  10916. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}&#x27;</span>,
  10917. {
  10918. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  10919. <span class="hljs-attr">headers</span>: headers
  10920. })
  10921. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  10922. <span class="hljs-keyword">return</span> res.json();
  10923. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  10924. <span class="hljs-built_in">console</span>.log(body);
  10925. });
  10926. </code></pre>
  10927. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  10928. <span class="hljs-keyword">const</span> headers = {
  10929. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  10930. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  10931. };
  10932. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}&#x27;</span>,
  10933. {
  10934. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  10935. <span class="hljs-attr">headers</span>: headers
  10936. })
  10937. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  10938. <span class="hljs-keyword">return</span> res.json();
  10939. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  10940. <span class="hljs-built_in">console</span>.log(body);
  10941. });
  10942. </code></pre>
  10943. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  10944. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  10945. headers = {
  10946. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  10947. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  10948. }
  10949. result = RestClient.delete <span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}&#x27;</span>,
  10950. <span class="hljs-symbol">params:</span> {
  10951. }, <span class="hljs-symbol">headers:</span> headers
  10952. p JSON.parse(result)
  10953. </code></pre>
  10954. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  10955. headers = {
  10956. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  10957. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  10958. }
  10959. r = requests.delete(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}&#x27;</span>, headers = headers)
  10960. <span class="hljs-built_in">print</span>(r.json())
  10961. </code></pre>
  10962. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/custom-fields/{customField}&quot;</span>);
  10963. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  10964. con.setRequestMethod(<span class="hljs-string">&quot;DELETE&quot;</span>);
  10965. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  10966. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  10967. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  10968. String inputLine;
  10969. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  10970. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  10971. response.append(inputLine);
  10972. }
  10973. in.close();
  10974. System.out.println(response.toString());
  10975. </code></pre>
  10976. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  10977. <span class="hljs-keyword">import</span> (
  10978. <span class="hljs-string">&quot;bytes&quot;</span>
  10979. <span class="hljs-string">&quot;net/http&quot;</span>
  10980. )
  10981. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  10982. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  10983. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  10984. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  10985. }
  10986. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  10987. req, err := http.NewRequest(<span class="hljs-string">&quot;DELETE&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/custom-fields/{customField}&quot;</span>, data)
  10988. req.Header = headers
  10989. client := &amp;http.Client{}
  10990. resp, err := client.Do(req)
  10991. <span class="hljs-comment">// ...</span>
  10992. }
  10993. </code></pre>
  10994. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  10995. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  10996. );
  10997. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  10998. <span class="hljs-comment">// Define array of request body.</span>
  10999. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  11000. <span class="hljs-keyword">try</span> {
  11001. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;DELETE&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}&#x27;</span>, <span class="hljs-keyword">array</span>(
  11002. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  11003. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  11004. )
  11005. );
  11006. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  11007. }
  11008. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  11009. <span class="hljs-comment">// handle exception or api errors.</span>
  11010. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  11011. }
  11012. <span class="hljs-comment">// ...</span>
  11013. </code></pre>
  11014. <p><code>DELETE /api/boards/{board}/custom-fields/{customField}</code></p>
  11015. <p><em>Delete a Custom Fields attached to a board</em></p>
  11016. <p>The Custom Field can't be retrieved after this operation</p>
  11017. <h3 id="delete_custom_field-parameters">Parameters</h3>
  11018. <table>
  11019. <thead>
  11020. <tr>
  11021. <th>Name</th>
  11022. <th>In</th>
  11023. <th>Type</th>
  11024. <th>Required</th>
  11025. <th>Description</th>
  11026. </tr>
  11027. </thead>
  11028. <tbody>
  11029. <tr>
  11030. <td>board</td>
  11031. <td>path</td>
  11032. <td>string</td>
  11033. <td>true</td>
  11034. <td>the board value</td>
  11035. </tr>
  11036. <tr>
  11037. <td>customField</td>
  11038. <td>path</td>
  11039. <td>string</td>
  11040. <td>true</td>
  11041. <td>the ID of the custom field</td>
  11042. </tr>
  11043. </tbody>
  11044. </table>
  11045. <h4 id="detailed-descriptions-32">Detailed descriptions</h4>
  11046. <p><strong>customField</strong>: the ID of the custom field</p>
  11047. <blockquote>
  11048. <p>Example responses</p>
  11049. </blockquote>
  11050. <blockquote>
  11051. <p>200 Response</p>
  11052. </blockquote>
  11053. <pre class="highlight tab tab-json"><code>{
  11054. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  11055. }
  11056. </code></pre>
  11057. <h3 id="delete_custom_field-responses">Responses</h3>
  11058. <table>
  11059. <thead>
  11060. <tr>
  11061. <th>Status</th>
  11062. <th>Meaning</th>
  11063. <th>Description</th>
  11064. <th>Schema</th>
  11065. </tr>
  11066. </thead>
  11067. <tbody>
  11068. <tr>
  11069. <td>200</td>
  11070. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  11071. <td>200 response</td>
  11072. <td>Inline</td>
  11073. </tr>
  11074. </tbody>
  11075. </table>
  11076. <h3 id="delete_custom_field-responseschema">Response Schema</h3>
  11077. <p>Status Code <strong>200</strong></p>
  11078. <table>
  11079. <thead>
  11080. <tr>
  11081. <th>Name</th>
  11082. <th>Type</th>
  11083. <th>Required</th>
  11084. <th>Restrictions</th>
  11085. <th>Description</th>
  11086. </tr>
  11087. </thead>
  11088. <tbody>
  11089. <tr>
  11090. <td>» _id</td>
  11091. <td>string</td>
  11092. <td>false</td>
  11093. <td>none</td>
  11094. <td>none</td>
  11095. </tr>
  11096. </tbody>
  11097. </table>
  11098. <aside class="warning">
  11099. To perform this operation, you must be authenticated by means of one of the following methods:
  11100. UserSecurity
  11101. </aside>
  11102. <h2 id="add_custom_field_dropdown_items">add_custom_field_dropdown_items</h2>
  11103. <p><a id="opIdadd_custom_field_dropdown_items"></a></p>
  11104. <blockquote>
  11105. <p>Code samples</p>
  11106. </blockquote>
  11107. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  11108. curl -X POST /api/boards/{board}/custom-fields/{customField}/dropdown-items \
  11109. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  11110. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  11111. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  11112. </code></pre>
  11113. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/boards/{board}/custom-fields/{customField}/dropdown-items</span> <span class="hljs-meta">HTTP/1.1</span>
  11114. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  11115. Accept: application/json
  11116. </span></code></pre>
  11117. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  11118. &quot;items&quot;: &quot;string&quot;
  11119. }&#x27;</span>;
  11120. <span class="hljs-keyword">const</span> headers = {
  11121. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  11122. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  11123. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  11124. };
  11125. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}/dropdown-items&#x27;</span>,
  11126. {
  11127. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  11128. <span class="hljs-attr">body</span>: inputBody,
  11129. <span class="hljs-attr">headers</span>: headers
  11130. })
  11131. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  11132. <span class="hljs-keyword">return</span> res.json();
  11133. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  11134. <span class="hljs-built_in">console</span>.log(body);
  11135. });
  11136. </code></pre>
  11137. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  11138. <span class="hljs-keyword">const</span> inputBody = {
  11139. <span class="hljs-string">&quot;items&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  11140. };
  11141. <span class="hljs-keyword">const</span> headers = {
  11142. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  11143. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  11144. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  11145. };
  11146. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}/dropdown-items&#x27;</span>,
  11147. {
  11148. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  11149. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  11150. <span class="hljs-attr">headers</span>: headers
  11151. })
  11152. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  11153. <span class="hljs-keyword">return</span> res.json();
  11154. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  11155. <span class="hljs-built_in">console</span>.log(body);
  11156. });
  11157. </code></pre>
  11158. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  11159. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  11160. headers = {
  11161. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  11162. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  11163. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  11164. }
  11165. result = RestClient.post <span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}/dropdown-items&#x27;</span>,
  11166. <span class="hljs-symbol">params:</span> {
  11167. }, <span class="hljs-symbol">headers:</span> headers
  11168. p JSON.parse(result)
  11169. </code></pre>
  11170. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  11171. headers = {
  11172. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  11173. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  11174. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  11175. }
  11176. r = requests.post(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}/dropdown-items&#x27;</span>, headers = headers)
  11177. <span class="hljs-built_in">print</span>(r.json())
  11178. </code></pre>
  11179. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/custom-fields/{customField}/dropdown-items&quot;</span>);
  11180. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  11181. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  11182. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  11183. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  11184. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  11185. String inputLine;
  11186. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  11187. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  11188. response.append(inputLine);
  11189. }
  11190. in.close();
  11191. System.out.println(response.toString());
  11192. </code></pre>
  11193. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  11194. <span class="hljs-keyword">import</span> (
  11195. <span class="hljs-string">&quot;bytes&quot;</span>
  11196. <span class="hljs-string">&quot;net/http&quot;</span>
  11197. )
  11198. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  11199. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  11200. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  11201. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  11202. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  11203. }
  11204. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  11205. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/custom-fields/{customField}/dropdown-items&quot;</span>, data)
  11206. req.Header = headers
  11207. client := &amp;http.Client{}
  11208. resp, err := client.Do(req)
  11209. <span class="hljs-comment">// ...</span>
  11210. }
  11211. </code></pre>
  11212. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  11213. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  11214. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  11215. );
  11216. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  11217. <span class="hljs-comment">// Define array of request body.</span>
  11218. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  11219. <span class="hljs-keyword">try</span> {
  11220. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}/dropdown-items&#x27;</span>, <span class="hljs-keyword">array</span>(
  11221. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  11222. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  11223. )
  11224. );
  11225. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  11226. }
  11227. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  11228. <span class="hljs-comment">// handle exception or api errors.</span>
  11229. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  11230. }
  11231. <span class="hljs-comment">// ...</span>
  11232. </code></pre>
  11233. <p><code>POST /api/boards/{board}/custom-fields/{customField}/dropdown-items</code></p>
  11234. <p><em>Update a Custom Field's dropdown items</em></p>
  11235. <blockquote>
  11236. <p>Body parameter</p>
  11237. </blockquote>
  11238. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">items:</span> <span class="hljs-string">string</span>
  11239. </code></pre>
  11240. <h3 id="add_custom_field_dropdown_items-parameters">Parameters</h3>
  11241. <table>
  11242. <thead>
  11243. <tr>
  11244. <th>Name</th>
  11245. <th>In</th>
  11246. <th>Type</th>
  11247. <th>Required</th>
  11248. <th>Description</th>
  11249. </tr>
  11250. </thead>
  11251. <tbody>
  11252. <tr>
  11253. <td>board</td>
  11254. <td>path</td>
  11255. <td>string</td>
  11256. <td>true</td>
  11257. <td>the board value</td>
  11258. </tr>
  11259. <tr>
  11260. <td>customField</td>
  11261. <td>path</td>
  11262. <td>string</td>
  11263. <td>true</td>
  11264. <td>the customField value</td>
  11265. </tr>
  11266. <tr>
  11267. <td>body</td>
  11268. <td>body</td>
  11269. <td>object</td>
  11270. <td>false</td>
  11271. <td>none</td>
  11272. </tr>
  11273. <tr>
  11274. <td>» items</td>
  11275. <td>body</td>
  11276. <td>string</td>
  11277. <td>false</td>
  11278. <td>names of the custom field</td>
  11279. </tr>
  11280. </tbody>
  11281. </table>
  11282. <blockquote>
  11283. <p>Example responses</p>
  11284. </blockquote>
  11285. <blockquote>
  11286. <p>200 Response</p>
  11287. </blockquote>
  11288. <pre class="highlight tab tab-json"><code>{
  11289. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  11290. }
  11291. </code></pre>
  11292. <h3 id="add_custom_field_dropdown_items-responses">Responses</h3>
  11293. <table>
  11294. <thead>
  11295. <tr>
  11296. <th>Status</th>
  11297. <th>Meaning</th>
  11298. <th>Description</th>
  11299. <th>Schema</th>
  11300. </tr>
  11301. </thead>
  11302. <tbody>
  11303. <tr>
  11304. <td>200</td>
  11305. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  11306. <td>200 response</td>
  11307. <td>Inline</td>
  11308. </tr>
  11309. </tbody>
  11310. </table>
  11311. <h3 id="add_custom_field_dropdown_items-responseschema">Response Schema</h3>
  11312. <p>Status Code <strong>200</strong></p>
  11313. <table>
  11314. <thead>
  11315. <tr>
  11316. <th>Name</th>
  11317. <th>Type</th>
  11318. <th>Required</th>
  11319. <th>Restrictions</th>
  11320. <th>Description</th>
  11321. </tr>
  11322. </thead>
  11323. <tbody>
  11324. <tr>
  11325. <td>» _id</td>
  11326. <td>string</td>
  11327. <td>false</td>
  11328. <td>none</td>
  11329. <td>none</td>
  11330. </tr>
  11331. </tbody>
  11332. </table>
  11333. <aside class="warning">
  11334. To perform this operation, you must be authenticated by means of one of the following methods:
  11335. UserSecurity
  11336. </aside>
  11337. <h2 id="edit_custom_field_dropdown_item">edit_custom_field_dropdown_item</h2>
  11338. <p><a id="opIdedit_custom_field_dropdown_item"></a></p>
  11339. <blockquote>
  11340. <p>Code samples</p>
  11341. </blockquote>
  11342. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  11343. curl -X PUT /api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem} \
  11344. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  11345. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  11346. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  11347. </code></pre>
  11348. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">PUT</span> <span class="hljs-string">/api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}</span> <span class="hljs-meta">HTTP/1.1</span>
  11349. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  11350. Accept: application/json
  11351. </span></code></pre>
  11352. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  11353. &quot;name&quot;: &quot;string&quot;
  11354. }&#x27;</span>;
  11355. <span class="hljs-keyword">const</span> headers = {
  11356. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  11357. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  11358. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  11359. };
  11360. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}&#x27;</span>,
  11361. {
  11362. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;PUT&#x27;</span>,
  11363. <span class="hljs-attr">body</span>: inputBody,
  11364. <span class="hljs-attr">headers</span>: headers
  11365. })
  11366. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  11367. <span class="hljs-keyword">return</span> res.json();
  11368. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  11369. <span class="hljs-built_in">console</span>.log(body);
  11370. });
  11371. </code></pre>
  11372. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  11373. <span class="hljs-keyword">const</span> inputBody = {
  11374. <span class="hljs-string">&quot;name&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  11375. };
  11376. <span class="hljs-keyword">const</span> headers = {
  11377. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  11378. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  11379. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  11380. };
  11381. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}&#x27;</span>,
  11382. {
  11383. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;PUT&#x27;</span>,
  11384. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  11385. <span class="hljs-attr">headers</span>: headers
  11386. })
  11387. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  11388. <span class="hljs-keyword">return</span> res.json();
  11389. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  11390. <span class="hljs-built_in">console</span>.log(body);
  11391. });
  11392. </code></pre>
  11393. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  11394. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  11395. headers = {
  11396. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  11397. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  11398. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  11399. }
  11400. result = RestClient.put <span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}&#x27;</span>,
  11401. <span class="hljs-symbol">params:</span> {
  11402. }, <span class="hljs-symbol">headers:</span> headers
  11403. p JSON.parse(result)
  11404. </code></pre>
  11405. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  11406. headers = {
  11407. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  11408. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  11409. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  11410. }
  11411. r = requests.put(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}&#x27;</span>, headers = headers)
  11412. <span class="hljs-built_in">print</span>(r.json())
  11413. </code></pre>
  11414. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}&quot;</span>);
  11415. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  11416. con.setRequestMethod(<span class="hljs-string">&quot;PUT&quot;</span>);
  11417. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  11418. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  11419. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  11420. String inputLine;
  11421. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  11422. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  11423. response.append(inputLine);
  11424. }
  11425. in.close();
  11426. System.out.println(response.toString());
  11427. </code></pre>
  11428. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  11429. <span class="hljs-keyword">import</span> (
  11430. <span class="hljs-string">&quot;bytes&quot;</span>
  11431. <span class="hljs-string">&quot;net/http&quot;</span>
  11432. )
  11433. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  11434. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  11435. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  11436. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  11437. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  11438. }
  11439. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  11440. req, err := http.NewRequest(<span class="hljs-string">&quot;PUT&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}&quot;</span>, data)
  11441. req.Header = headers
  11442. client := &amp;http.Client{}
  11443. resp, err := client.Do(req)
  11444. <span class="hljs-comment">// ...</span>
  11445. }
  11446. </code></pre>
  11447. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  11448. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  11449. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  11450. );
  11451. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  11452. <span class="hljs-comment">// Define array of request body.</span>
  11453. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  11454. <span class="hljs-keyword">try</span> {
  11455. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;PUT&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}&#x27;</span>, <span class="hljs-keyword">array</span>(
  11456. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  11457. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  11458. )
  11459. );
  11460. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  11461. }
  11462. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  11463. <span class="hljs-comment">// handle exception or api errors.</span>
  11464. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  11465. }
  11466. <span class="hljs-comment">// ...</span>
  11467. </code></pre>
  11468. <p><code>PUT /api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}</code></p>
  11469. <p><em>Update a Custom Field's dropdown item</em></p>
  11470. <blockquote>
  11471. <p>Body parameter</p>
  11472. </blockquote>
  11473. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">name:</span> <span class="hljs-string">string</span>
  11474. </code></pre>
  11475. <h3 id="edit_custom_field_dropdown_item-parameters">Parameters</h3>
  11476. <table>
  11477. <thead>
  11478. <tr>
  11479. <th>Name</th>
  11480. <th>In</th>
  11481. <th>Type</th>
  11482. <th>Required</th>
  11483. <th>Description</th>
  11484. </tr>
  11485. </thead>
  11486. <tbody>
  11487. <tr>
  11488. <td>board</td>
  11489. <td>path</td>
  11490. <td>string</td>
  11491. <td>true</td>
  11492. <td>the board value</td>
  11493. </tr>
  11494. <tr>
  11495. <td>customField</td>
  11496. <td>path</td>
  11497. <td>string</td>
  11498. <td>true</td>
  11499. <td>the customField value</td>
  11500. </tr>
  11501. <tr>
  11502. <td>dropdownItem</td>
  11503. <td>path</td>
  11504. <td>string</td>
  11505. <td>true</td>
  11506. <td>the dropdownItem value</td>
  11507. </tr>
  11508. <tr>
  11509. <td>body</td>
  11510. <td>body</td>
  11511. <td>object</td>
  11512. <td>true</td>
  11513. <td>none</td>
  11514. </tr>
  11515. <tr>
  11516. <td>» name</td>
  11517. <td>body</td>
  11518. <td>string</td>
  11519. <td>true</td>
  11520. <td>names of the custom field</td>
  11521. </tr>
  11522. </tbody>
  11523. </table>
  11524. <blockquote>
  11525. <p>Example responses</p>
  11526. </blockquote>
  11527. <blockquote>
  11528. <p>200 Response</p>
  11529. </blockquote>
  11530. <pre class="highlight tab tab-json"><code>{
  11531. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  11532. }
  11533. </code></pre>
  11534. <h3 id="edit_custom_field_dropdown_item-responses">Responses</h3>
  11535. <table>
  11536. <thead>
  11537. <tr>
  11538. <th>Status</th>
  11539. <th>Meaning</th>
  11540. <th>Description</th>
  11541. <th>Schema</th>
  11542. </tr>
  11543. </thead>
  11544. <tbody>
  11545. <tr>
  11546. <td>200</td>
  11547. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  11548. <td>200 response</td>
  11549. <td>Inline</td>
  11550. </tr>
  11551. </tbody>
  11552. </table>
  11553. <h3 id="edit_custom_field_dropdown_item-responseschema">Response Schema</h3>
  11554. <p>Status Code <strong>200</strong></p>
  11555. <table>
  11556. <thead>
  11557. <tr>
  11558. <th>Name</th>
  11559. <th>Type</th>
  11560. <th>Required</th>
  11561. <th>Restrictions</th>
  11562. <th>Description</th>
  11563. </tr>
  11564. </thead>
  11565. <tbody>
  11566. <tr>
  11567. <td>» _id</td>
  11568. <td>string</td>
  11569. <td>false</td>
  11570. <td>none</td>
  11571. <td>none</td>
  11572. </tr>
  11573. </tbody>
  11574. </table>
  11575. <aside class="warning">
  11576. To perform this operation, you must be authenticated by means of one of the following methods:
  11577. UserSecurity
  11578. </aside>
  11579. <h2 id="delete_custom_field_dropdown_item">delete_custom_field_dropdown_item</h2>
  11580. <p><a id="opIddelete_custom_field_dropdown_item"></a></p>
  11581. <blockquote>
  11582. <p>Code samples</p>
  11583. </blockquote>
  11584. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  11585. curl -X DELETE /api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem} \
  11586. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  11587. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  11588. </code></pre>
  11589. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">DELETE</span> <span class="hljs-string">/api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}</span> <span class="hljs-meta">HTTP/1.1</span>
  11590. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  11591. </span></code></pre>
  11592. <pre class="highlight tab tab-javascript"><code>
  11593. <span class="hljs-keyword">const</span> headers = {
  11594. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  11595. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  11596. };
  11597. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}&#x27;</span>,
  11598. {
  11599. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  11600. <span class="hljs-attr">headers</span>: headers
  11601. })
  11602. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  11603. <span class="hljs-keyword">return</span> res.json();
  11604. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  11605. <span class="hljs-built_in">console</span>.log(body);
  11606. });
  11607. </code></pre>
  11608. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  11609. <span class="hljs-keyword">const</span> headers = {
  11610. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  11611. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  11612. };
  11613. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}&#x27;</span>,
  11614. {
  11615. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  11616. <span class="hljs-attr">headers</span>: headers
  11617. })
  11618. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  11619. <span class="hljs-keyword">return</span> res.json();
  11620. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  11621. <span class="hljs-built_in">console</span>.log(body);
  11622. });
  11623. </code></pre>
  11624. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  11625. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  11626. headers = {
  11627. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  11628. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  11629. }
  11630. result = RestClient.delete <span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}&#x27;</span>,
  11631. <span class="hljs-symbol">params:</span> {
  11632. }, <span class="hljs-symbol">headers:</span> headers
  11633. p JSON.parse(result)
  11634. </code></pre>
  11635. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  11636. headers = {
  11637. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  11638. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  11639. }
  11640. r = requests.delete(<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}&#x27;</span>, headers = headers)
  11641. <span class="hljs-built_in">print</span>(r.json())
  11642. </code></pre>
  11643. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}&quot;</span>);
  11644. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  11645. con.setRequestMethod(<span class="hljs-string">&quot;DELETE&quot;</span>);
  11646. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  11647. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  11648. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  11649. String inputLine;
  11650. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  11651. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  11652. response.append(inputLine);
  11653. }
  11654. in.close();
  11655. System.out.println(response.toString());
  11656. </code></pre>
  11657. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  11658. <span class="hljs-keyword">import</span> (
  11659. <span class="hljs-string">&quot;bytes&quot;</span>
  11660. <span class="hljs-string">&quot;net/http&quot;</span>
  11661. )
  11662. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  11663. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  11664. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  11665. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  11666. }
  11667. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  11668. req, err := http.NewRequest(<span class="hljs-string">&quot;DELETE&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}&quot;</span>, data)
  11669. req.Header = headers
  11670. client := &amp;http.Client{}
  11671. resp, err := client.Do(req)
  11672. <span class="hljs-comment">// ...</span>
  11673. }
  11674. </code></pre>
  11675. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  11676. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  11677. );
  11678. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  11679. <span class="hljs-comment">// Define array of request body.</span>
  11680. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  11681. <span class="hljs-keyword">try</span> {
  11682. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;DELETE&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}&#x27;</span>, <span class="hljs-keyword">array</span>(
  11683. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  11684. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  11685. )
  11686. );
  11687. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  11688. }
  11689. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  11690. <span class="hljs-comment">// handle exception or api errors.</span>
  11691. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  11692. }
  11693. <span class="hljs-comment">// ...</span>
  11694. </code></pre>
  11695. <p><code>DELETE /api/boards/{board}/custom-fields/{customField}/dropdown-items/{dropdownItem}</code></p>
  11696. <p><em>Update a Custom Field's dropdown items</em></p>
  11697. <h3 id="delete_custom_field_dropdown_item-parameters">Parameters</h3>
  11698. <table>
  11699. <thead>
  11700. <tr>
  11701. <th>Name</th>
  11702. <th>In</th>
  11703. <th>Type</th>
  11704. <th>Required</th>
  11705. <th>Description</th>
  11706. </tr>
  11707. </thead>
  11708. <tbody>
  11709. <tr>
  11710. <td>board</td>
  11711. <td>path</td>
  11712. <td>string</td>
  11713. <td>true</td>
  11714. <td>the board value</td>
  11715. </tr>
  11716. <tr>
  11717. <td>customField</td>
  11718. <td>path</td>
  11719. <td>string</td>
  11720. <td>true</td>
  11721. <td>the customField value</td>
  11722. </tr>
  11723. <tr>
  11724. <td>dropdownItem</td>
  11725. <td>path</td>
  11726. <td>string</td>
  11727. <td>true</td>
  11728. <td>the dropdownItem value</td>
  11729. </tr>
  11730. </tbody>
  11731. </table>
  11732. <blockquote>
  11733. <p>Example responses</p>
  11734. </blockquote>
  11735. <blockquote>
  11736. <p>200 Response</p>
  11737. </blockquote>
  11738. <pre class="highlight tab tab-json"><code>{
  11739. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  11740. }
  11741. </code></pre>
  11742. <h3 id="delete_custom_field_dropdown_item-responses">Responses</h3>
  11743. <table>
  11744. <thead>
  11745. <tr>
  11746. <th>Status</th>
  11747. <th>Meaning</th>
  11748. <th>Description</th>
  11749. <th>Schema</th>
  11750. </tr>
  11751. </thead>
  11752. <tbody>
  11753. <tr>
  11754. <td>200</td>
  11755. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  11756. <td>200 response</td>
  11757. <td>Inline</td>
  11758. </tr>
  11759. </tbody>
  11760. </table>
  11761. <h3 id="delete_custom_field_dropdown_item-responseschema">Response Schema</h3>
  11762. <p>Status Code <strong>200</strong></p>
  11763. <table>
  11764. <thead>
  11765. <tr>
  11766. <th>Name</th>
  11767. <th>Type</th>
  11768. <th>Required</th>
  11769. <th>Restrictions</th>
  11770. <th>Description</th>
  11771. </tr>
  11772. </thead>
  11773. <tbody>
  11774. <tr>
  11775. <td>» _id</td>
  11776. <td>string</td>
  11777. <td>false</td>
  11778. <td>none</td>
  11779. <td>none</td>
  11780. </tr>
  11781. </tbody>
  11782. </table>
  11783. <aside class="warning">
  11784. To perform this operation, you must be authenticated by means of one of the following methods:
  11785. UserSecurity
  11786. </aside>
  11787. <h1 id="wekan-rest-api-integrations">Integrations</h1>
  11788. <h2 id="get_all_integrations">get_all_integrations</h2>
  11789. <p><a id="opIdget_all_integrations"></a></p>
  11790. <blockquote>
  11791. <p>Code samples</p>
  11792. </blockquote>
  11793. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  11794. curl -X GET /api/boards/{board}/integrations \
  11795. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  11796. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  11797. </code></pre>
  11798. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/integrations</span> <span class="hljs-meta">HTTP/1.1</span>
  11799. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  11800. </span></code></pre>
  11801. <pre class="highlight tab tab-javascript"><code>
  11802. <span class="hljs-keyword">const</span> headers = {
  11803. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  11804. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  11805. };
  11806. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/integrations&#x27;</span>,
  11807. {
  11808. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  11809. <span class="hljs-attr">headers</span>: headers
  11810. })
  11811. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  11812. <span class="hljs-keyword">return</span> res.json();
  11813. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  11814. <span class="hljs-built_in">console</span>.log(body);
  11815. });
  11816. </code></pre>
  11817. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  11818. <span class="hljs-keyword">const</span> headers = {
  11819. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  11820. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  11821. };
  11822. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/integrations&#x27;</span>,
  11823. {
  11824. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  11825. <span class="hljs-attr">headers</span>: headers
  11826. })
  11827. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  11828. <span class="hljs-keyword">return</span> res.json();
  11829. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  11830. <span class="hljs-built_in">console</span>.log(body);
  11831. });
  11832. </code></pre>
  11833. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  11834. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  11835. headers = {
  11836. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  11837. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  11838. }
  11839. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/integrations&#x27;</span>,
  11840. <span class="hljs-symbol">params:</span> {
  11841. }, <span class="hljs-symbol">headers:</span> headers
  11842. p JSON.parse(result)
  11843. </code></pre>
  11844. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  11845. headers = {
  11846. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  11847. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  11848. }
  11849. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/integrations&#x27;</span>, headers = headers)
  11850. <span class="hljs-built_in">print</span>(r.json())
  11851. </code></pre>
  11852. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/integrations&quot;</span>);
  11853. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  11854. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  11855. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  11856. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  11857. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  11858. String inputLine;
  11859. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  11860. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  11861. response.append(inputLine);
  11862. }
  11863. in.close();
  11864. System.out.println(response.toString());
  11865. </code></pre>
  11866. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  11867. <span class="hljs-keyword">import</span> (
  11868. <span class="hljs-string">&quot;bytes&quot;</span>
  11869. <span class="hljs-string">&quot;net/http&quot;</span>
  11870. )
  11871. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  11872. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  11873. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  11874. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  11875. }
  11876. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  11877. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/integrations&quot;</span>, data)
  11878. req.Header = headers
  11879. client := &amp;http.Client{}
  11880. resp, err := client.Do(req)
  11881. <span class="hljs-comment">// ...</span>
  11882. }
  11883. </code></pre>
  11884. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  11885. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  11886. );
  11887. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  11888. <span class="hljs-comment">// Define array of request body.</span>
  11889. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  11890. <span class="hljs-keyword">try</span> {
  11891. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/integrations&#x27;</span>, <span class="hljs-keyword">array</span>(
  11892. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  11893. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  11894. )
  11895. );
  11896. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  11897. }
  11898. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  11899. <span class="hljs-comment">// handle exception or api errors.</span>
  11900. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  11901. }
  11902. <span class="hljs-comment">// ...</span>
  11903. </code></pre>
  11904. <p><code>GET /api/boards/{board}/integrations</code></p>
  11905. <p><em>Get all integrations in board</em></p>
  11906. <h3 id="get_all_integrations-parameters">Parameters</h3>
  11907. <table>
  11908. <thead>
  11909. <tr>
  11910. <th>Name</th>
  11911. <th>In</th>
  11912. <th>Type</th>
  11913. <th>Required</th>
  11914. <th>Description</th>
  11915. </tr>
  11916. </thead>
  11917. <tbody>
  11918. <tr>
  11919. <td>board</td>
  11920. <td>path</td>
  11921. <td>string</td>
  11922. <td>true</td>
  11923. <td>the board ID</td>
  11924. </tr>
  11925. </tbody>
  11926. </table>
  11927. <h4 id="detailed-descriptions-33">Detailed descriptions</h4>
  11928. <p><strong>board</strong>: the board ID</p>
  11929. <blockquote>
  11930. <p>Example responses</p>
  11931. </blockquote>
  11932. <blockquote>
  11933. <p>200 Response</p>
  11934. </blockquote>
  11935. <pre class="highlight tab tab-json"><code>[
  11936. {
  11937. <span class="hljs-attr">&quot;enabled&quot;</span>: <span class="hljs-literal">true</span>,
  11938. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  11939. <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  11940. <span class="hljs-attr">&quot;activities&quot;</span>: [
  11941. <span class="hljs-string">&quot;string&quot;</span>
  11942. ],
  11943. <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  11944. <span class="hljs-attr">&quot;token&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  11945. <span class="hljs-attr">&quot;boardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  11946. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  11947. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  11948. <span class="hljs-attr">&quot;userId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  11949. }
  11950. ]
  11951. </code></pre>
  11952. <h3 id="get_all_integrations-responses">Responses</h3>
  11953. <table>
  11954. <thead>
  11955. <tr>
  11956. <th>Status</th>
  11957. <th>Meaning</th>
  11958. <th>Description</th>
  11959. <th>Schema</th>
  11960. </tr>
  11961. </thead>
  11962. <tbody>
  11963. <tr>
  11964. <td>200</td>
  11965. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  11966. <td>200 response</td>
  11967. <td>Inline</td>
  11968. </tr>
  11969. </tbody>
  11970. </table>
  11971. <h3 id="get_all_integrations-responseschema">Response Schema</h3>
  11972. <p>Status Code <strong>200</strong></p>
  11973. <table>
  11974. <thead>
  11975. <tr>
  11976. <th>Name</th>
  11977. <th>Type</th>
  11978. <th>Required</th>
  11979. <th>Restrictions</th>
  11980. <th>Description</th>
  11981. </tr>
  11982. </thead>
  11983. <tbody>
  11984. <tr>
  11985. <td><em>anonymous</em></td>
  11986. <td>[<a href="#schemaintegrations">Integrations</a>]</td>
  11987. <td>false</td>
  11988. <td>none</td>
  11989. <td>[Integration with third-party applications]</td>
  11990. </tr>
  11991. <tr>
  11992. <td>» enabled</td>
  11993. <td>boolean</td>
  11994. <td>true</td>
  11995. <td>none</td>
  11996. <td>is the integration enabled?</td>
  11997. </tr>
  11998. <tr>
  11999. <td>» title</td>
  12000. <td>string¦null</td>
  12001. <td>false</td>
  12002. <td>none</td>
  12003. <td>name of the integration</td>
  12004. </tr>
  12005. <tr>
  12006. <td>» type</td>
  12007. <td>string</td>
  12008. <td>true</td>
  12009. <td>none</td>
  12010. <td>type of the integratation (Default to 'outgoing-webhooks')</td>
  12011. </tr>
  12012. <tr>
  12013. <td>» activities</td>
  12014. <td>[string]</td>
  12015. <td>true</td>
  12016. <td>none</td>
  12017. <td>activities the integration gets triggered (list)</td>
  12018. </tr>
  12019. <tr>
  12020. <td>» url</td>
  12021. <td>string</td>
  12022. <td>true</td>
  12023. <td>none</td>
  12024. <td>none</td>
  12025. </tr>
  12026. <tr>
  12027. <td>» token</td>
  12028. <td>string¦null</td>
  12029. <td>false</td>
  12030. <td>none</td>
  12031. <td>token of the integration</td>
  12032. </tr>
  12033. <tr>
  12034. <td>» boardId</td>
  12035. <td>string</td>
  12036. <td>true</td>
  12037. <td>none</td>
  12038. <td>Board ID of the integration</td>
  12039. </tr>
  12040. <tr>
  12041. <td>» createdAt</td>
  12042. <td>string</td>
  12043. <td>true</td>
  12044. <td>none</td>
  12045. <td>Creation date of the integration</td>
  12046. </tr>
  12047. <tr>
  12048. <td>» modifiedAt</td>
  12049. <td>string</td>
  12050. <td>true</td>
  12051. <td>none</td>
  12052. <td>none</td>
  12053. </tr>
  12054. <tr>
  12055. <td>» userId</td>
  12056. <td>string</td>
  12057. <td>true</td>
  12058. <td>none</td>
  12059. <td>user ID who created the interation</td>
  12060. </tr>
  12061. </tbody>
  12062. </table>
  12063. <aside class="warning">
  12064. To perform this operation, you must be authenticated by means of one of the following methods:
  12065. UserSecurity
  12066. </aside>
  12067. <h2 id="new_integration">new_integration</h2>
  12068. <p><a id="opIdnew_integration"></a></p>
  12069. <blockquote>
  12070. <p>Code samples</p>
  12071. </blockquote>
  12072. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  12073. curl -X POST /api/boards/{board}/integrations \
  12074. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  12075. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  12076. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  12077. </code></pre>
  12078. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/boards/{board}/integrations</span> <span class="hljs-meta">HTTP/1.1</span>
  12079. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  12080. Accept: application/json
  12081. </span></code></pre>
  12082. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  12083. &quot;url&quot;: &quot;string&quot;
  12084. }&#x27;</span>;
  12085. <span class="hljs-keyword">const</span> headers = {
  12086. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  12087. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  12088. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  12089. };
  12090. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/integrations&#x27;</span>,
  12091. {
  12092. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  12093. <span class="hljs-attr">body</span>: inputBody,
  12094. <span class="hljs-attr">headers</span>: headers
  12095. })
  12096. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  12097. <span class="hljs-keyword">return</span> res.json();
  12098. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  12099. <span class="hljs-built_in">console</span>.log(body);
  12100. });
  12101. </code></pre>
  12102. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  12103. <span class="hljs-keyword">const</span> inputBody = {
  12104. <span class="hljs-string">&quot;url&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  12105. };
  12106. <span class="hljs-keyword">const</span> headers = {
  12107. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  12108. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  12109. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  12110. };
  12111. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/integrations&#x27;</span>,
  12112. {
  12113. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  12114. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  12115. <span class="hljs-attr">headers</span>: headers
  12116. })
  12117. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  12118. <span class="hljs-keyword">return</span> res.json();
  12119. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  12120. <span class="hljs-built_in">console</span>.log(body);
  12121. });
  12122. </code></pre>
  12123. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  12124. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  12125. headers = {
  12126. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  12127. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  12128. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  12129. }
  12130. result = RestClient.post <span class="hljs-string">&#x27;/api/boards/{board}/integrations&#x27;</span>,
  12131. <span class="hljs-symbol">params:</span> {
  12132. }, <span class="hljs-symbol">headers:</span> headers
  12133. p JSON.parse(result)
  12134. </code></pre>
  12135. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  12136. headers = {
  12137. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  12138. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  12139. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  12140. }
  12141. r = requests.post(<span class="hljs-string">&#x27;/api/boards/{board}/integrations&#x27;</span>, headers = headers)
  12142. <span class="hljs-built_in">print</span>(r.json())
  12143. </code></pre>
  12144. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/integrations&quot;</span>);
  12145. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  12146. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  12147. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  12148. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  12149. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  12150. String inputLine;
  12151. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  12152. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  12153. response.append(inputLine);
  12154. }
  12155. in.close();
  12156. System.out.println(response.toString());
  12157. </code></pre>
  12158. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  12159. <span class="hljs-keyword">import</span> (
  12160. <span class="hljs-string">&quot;bytes&quot;</span>
  12161. <span class="hljs-string">&quot;net/http&quot;</span>
  12162. )
  12163. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  12164. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  12165. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  12166. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  12167. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  12168. }
  12169. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  12170. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/integrations&quot;</span>, data)
  12171. req.Header = headers
  12172. client := &amp;http.Client{}
  12173. resp, err := client.Do(req)
  12174. <span class="hljs-comment">// ...</span>
  12175. }
  12176. </code></pre>
  12177. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  12178. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  12179. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  12180. );
  12181. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  12182. <span class="hljs-comment">// Define array of request body.</span>
  12183. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  12184. <span class="hljs-keyword">try</span> {
  12185. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/integrations&#x27;</span>, <span class="hljs-keyword">array</span>(
  12186. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  12187. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  12188. )
  12189. );
  12190. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  12191. }
  12192. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  12193. <span class="hljs-comment">// handle exception or api errors.</span>
  12194. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  12195. }
  12196. <span class="hljs-comment">// ...</span>
  12197. </code></pre>
  12198. <p><code>POST /api/boards/{board}/integrations</code></p>
  12199. <p><em>Create a new integration</em></p>
  12200. <blockquote>
  12201. <p>Body parameter</p>
  12202. </blockquote>
  12203. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">url:</span> <span class="hljs-string">string</span>
  12204. </code></pre>
  12205. <h3 id="new_integration-parameters">Parameters</h3>
  12206. <table>
  12207. <thead>
  12208. <tr>
  12209. <th>Name</th>
  12210. <th>In</th>
  12211. <th>Type</th>
  12212. <th>Required</th>
  12213. <th>Description</th>
  12214. </tr>
  12215. </thead>
  12216. <tbody>
  12217. <tr>
  12218. <td>board</td>
  12219. <td>path</td>
  12220. <td>string</td>
  12221. <td>true</td>
  12222. <td>the board ID</td>
  12223. </tr>
  12224. <tr>
  12225. <td>body</td>
  12226. <td>body</td>
  12227. <td>object</td>
  12228. <td>true</td>
  12229. <td>none</td>
  12230. </tr>
  12231. <tr>
  12232. <td>» url</td>
  12233. <td>body</td>
  12234. <td>string</td>
  12235. <td>true</td>
  12236. <td>the URL of the integration</td>
  12237. </tr>
  12238. </tbody>
  12239. </table>
  12240. <h4 id="detailed-descriptions-34">Detailed descriptions</h4>
  12241. <p><strong>board</strong>: the board ID</p>
  12242. <blockquote>
  12243. <p>Example responses</p>
  12244. </blockquote>
  12245. <blockquote>
  12246. <p>200 Response</p>
  12247. </blockquote>
  12248. <pre class="highlight tab tab-json"><code>{
  12249. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  12250. }
  12251. </code></pre>
  12252. <h3 id="new_integration-responses">Responses</h3>
  12253. <table>
  12254. <thead>
  12255. <tr>
  12256. <th>Status</th>
  12257. <th>Meaning</th>
  12258. <th>Description</th>
  12259. <th>Schema</th>
  12260. </tr>
  12261. </thead>
  12262. <tbody>
  12263. <tr>
  12264. <td>200</td>
  12265. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  12266. <td>200 response</td>
  12267. <td>Inline</td>
  12268. </tr>
  12269. </tbody>
  12270. </table>
  12271. <h3 id="new_integration-responseschema">Response Schema</h3>
  12272. <p>Status Code <strong>200</strong></p>
  12273. <table>
  12274. <thead>
  12275. <tr>
  12276. <th>Name</th>
  12277. <th>Type</th>
  12278. <th>Required</th>
  12279. <th>Restrictions</th>
  12280. <th>Description</th>
  12281. </tr>
  12282. </thead>
  12283. <tbody>
  12284. <tr>
  12285. <td>» _id</td>
  12286. <td>string</td>
  12287. <td>false</td>
  12288. <td>none</td>
  12289. <td>none</td>
  12290. </tr>
  12291. </tbody>
  12292. </table>
  12293. <aside class="warning">
  12294. To perform this operation, you must be authenticated by means of one of the following methods:
  12295. UserSecurity
  12296. </aside>
  12297. <h2 id="get_integration">get_integration</h2>
  12298. <p><a id="opIdget_integration"></a></p>
  12299. <blockquote>
  12300. <p>Code samples</p>
  12301. </blockquote>
  12302. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  12303. curl -X GET /api/boards/{board}/integrations/{int} \
  12304. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  12305. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  12306. </code></pre>
  12307. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/integrations/{int}</span> <span class="hljs-meta">HTTP/1.1</span>
  12308. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  12309. </span></code></pre>
  12310. <pre class="highlight tab tab-javascript"><code>
  12311. <span class="hljs-keyword">const</span> headers = {
  12312. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  12313. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  12314. };
  12315. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}&#x27;</span>,
  12316. {
  12317. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  12318. <span class="hljs-attr">headers</span>: headers
  12319. })
  12320. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  12321. <span class="hljs-keyword">return</span> res.json();
  12322. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  12323. <span class="hljs-built_in">console</span>.log(body);
  12324. });
  12325. </code></pre>
  12326. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  12327. <span class="hljs-keyword">const</span> headers = {
  12328. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  12329. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  12330. };
  12331. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}&#x27;</span>,
  12332. {
  12333. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  12334. <span class="hljs-attr">headers</span>: headers
  12335. })
  12336. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  12337. <span class="hljs-keyword">return</span> res.json();
  12338. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  12339. <span class="hljs-built_in">console</span>.log(body);
  12340. });
  12341. </code></pre>
  12342. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  12343. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  12344. headers = {
  12345. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  12346. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  12347. }
  12348. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}&#x27;</span>,
  12349. <span class="hljs-symbol">params:</span> {
  12350. }, <span class="hljs-symbol">headers:</span> headers
  12351. p JSON.parse(result)
  12352. </code></pre>
  12353. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  12354. headers = {
  12355. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  12356. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  12357. }
  12358. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}&#x27;</span>, headers = headers)
  12359. <span class="hljs-built_in">print</span>(r.json())
  12360. </code></pre>
  12361. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/integrations/{int}&quot;</span>);
  12362. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  12363. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  12364. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  12365. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  12366. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  12367. String inputLine;
  12368. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  12369. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  12370. response.append(inputLine);
  12371. }
  12372. in.close();
  12373. System.out.println(response.toString());
  12374. </code></pre>
  12375. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  12376. <span class="hljs-keyword">import</span> (
  12377. <span class="hljs-string">&quot;bytes&quot;</span>
  12378. <span class="hljs-string">&quot;net/http&quot;</span>
  12379. )
  12380. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  12381. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  12382. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  12383. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  12384. }
  12385. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  12386. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/integrations/{int}&quot;</span>, data)
  12387. req.Header = headers
  12388. client := &amp;http.Client{}
  12389. resp, err := client.Do(req)
  12390. <span class="hljs-comment">// ...</span>
  12391. }
  12392. </code></pre>
  12393. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  12394. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  12395. );
  12396. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  12397. <span class="hljs-comment">// Define array of request body.</span>
  12398. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  12399. <span class="hljs-keyword">try</span> {
  12400. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}&#x27;</span>, <span class="hljs-keyword">array</span>(
  12401. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  12402. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  12403. )
  12404. );
  12405. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  12406. }
  12407. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  12408. <span class="hljs-comment">// handle exception or api errors.</span>
  12409. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  12410. }
  12411. <span class="hljs-comment">// ...</span>
  12412. </code></pre>
  12413. <p><code>GET /api/boards/{board}/integrations/{int}</code></p>
  12414. <p><em>Get a single integration in board</em></p>
  12415. <h3 id="get_integration-parameters">Parameters</h3>
  12416. <table>
  12417. <thead>
  12418. <tr>
  12419. <th>Name</th>
  12420. <th>In</th>
  12421. <th>Type</th>
  12422. <th>Required</th>
  12423. <th>Description</th>
  12424. </tr>
  12425. </thead>
  12426. <tbody>
  12427. <tr>
  12428. <td>board</td>
  12429. <td>path</td>
  12430. <td>string</td>
  12431. <td>true</td>
  12432. <td>the board ID</td>
  12433. </tr>
  12434. <tr>
  12435. <td>int</td>
  12436. <td>path</td>
  12437. <td>string</td>
  12438. <td>true</td>
  12439. <td>the integration ID</td>
  12440. </tr>
  12441. </tbody>
  12442. </table>
  12443. <h4 id="detailed-descriptions-35">Detailed descriptions</h4>
  12444. <p><strong>board</strong>: the board ID</p>
  12445. <p><strong>int</strong>: the integration ID</p>
  12446. <blockquote>
  12447. <p>Example responses</p>
  12448. </blockquote>
  12449. <blockquote>
  12450. <p>200 Response</p>
  12451. </blockquote>
  12452. <pre class="highlight tab tab-json"><code>{
  12453. <span class="hljs-attr">&quot;enabled&quot;</span>: <span class="hljs-literal">true</span>,
  12454. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  12455. <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  12456. <span class="hljs-attr">&quot;activities&quot;</span>: [
  12457. <span class="hljs-string">&quot;string&quot;</span>
  12458. ],
  12459. <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  12460. <span class="hljs-attr">&quot;token&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  12461. <span class="hljs-attr">&quot;boardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  12462. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  12463. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  12464. <span class="hljs-attr">&quot;userId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  12465. }
  12466. </code></pre>
  12467. <h3 id="get_integration-responses">Responses</h3>
  12468. <table>
  12469. <thead>
  12470. <tr>
  12471. <th>Status</th>
  12472. <th>Meaning</th>
  12473. <th>Description</th>
  12474. <th>Schema</th>
  12475. </tr>
  12476. </thead>
  12477. <tbody>
  12478. <tr>
  12479. <td>200</td>
  12480. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  12481. <td>200 response</td>
  12482. <td><a href="#schemaintegrations">Integrations</a></td>
  12483. </tr>
  12484. </tbody>
  12485. </table>
  12486. <aside class="warning">
  12487. To perform this operation, you must be authenticated by means of one of the following methods:
  12488. UserSecurity
  12489. </aside>
  12490. <h2 id="edit_integration">edit_integration</h2>
  12491. <p><a id="opIdedit_integration"></a></p>
  12492. <blockquote>
  12493. <p>Code samples</p>
  12494. </blockquote>
  12495. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  12496. curl -X PUT /api/boards/{board}/integrations/{int} \
  12497. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  12498. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  12499. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  12500. </code></pre>
  12501. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">PUT</span> <span class="hljs-string">/api/boards/{board}/integrations/{int}</span> <span class="hljs-meta">HTTP/1.1</span>
  12502. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  12503. Accept: application/json
  12504. </span></code></pre>
  12505. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  12506. &quot;enabled&quot;: &quot;string&quot;,
  12507. &quot;title&quot;: &quot;string&quot;,
  12508. &quot;url&quot;: &quot;string&quot;,
  12509. &quot;token&quot;: &quot;string&quot;,
  12510. &quot;activities&quot;: &quot;string&quot;
  12511. }&#x27;</span>;
  12512. <span class="hljs-keyword">const</span> headers = {
  12513. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  12514. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  12515. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  12516. };
  12517. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}&#x27;</span>,
  12518. {
  12519. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;PUT&#x27;</span>,
  12520. <span class="hljs-attr">body</span>: inputBody,
  12521. <span class="hljs-attr">headers</span>: headers
  12522. })
  12523. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  12524. <span class="hljs-keyword">return</span> res.json();
  12525. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  12526. <span class="hljs-built_in">console</span>.log(body);
  12527. });
  12528. </code></pre>
  12529. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  12530. <span class="hljs-keyword">const</span> inputBody = {
  12531. <span class="hljs-string">&quot;enabled&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  12532. <span class="hljs-string">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  12533. <span class="hljs-string">&quot;url&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  12534. <span class="hljs-string">&quot;token&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  12535. <span class="hljs-string">&quot;activities&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  12536. };
  12537. <span class="hljs-keyword">const</span> headers = {
  12538. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  12539. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  12540. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  12541. };
  12542. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}&#x27;</span>,
  12543. {
  12544. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;PUT&#x27;</span>,
  12545. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  12546. <span class="hljs-attr">headers</span>: headers
  12547. })
  12548. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  12549. <span class="hljs-keyword">return</span> res.json();
  12550. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  12551. <span class="hljs-built_in">console</span>.log(body);
  12552. });
  12553. </code></pre>
  12554. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  12555. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  12556. headers = {
  12557. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  12558. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  12559. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  12560. }
  12561. result = RestClient.put <span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}&#x27;</span>,
  12562. <span class="hljs-symbol">params:</span> {
  12563. }, <span class="hljs-symbol">headers:</span> headers
  12564. p JSON.parse(result)
  12565. </code></pre>
  12566. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  12567. headers = {
  12568. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  12569. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  12570. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  12571. }
  12572. r = requests.put(<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}&#x27;</span>, headers = headers)
  12573. <span class="hljs-built_in">print</span>(r.json())
  12574. </code></pre>
  12575. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/integrations/{int}&quot;</span>);
  12576. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  12577. con.setRequestMethod(<span class="hljs-string">&quot;PUT&quot;</span>);
  12578. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  12579. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  12580. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  12581. String inputLine;
  12582. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  12583. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  12584. response.append(inputLine);
  12585. }
  12586. in.close();
  12587. System.out.println(response.toString());
  12588. </code></pre>
  12589. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  12590. <span class="hljs-keyword">import</span> (
  12591. <span class="hljs-string">&quot;bytes&quot;</span>
  12592. <span class="hljs-string">&quot;net/http&quot;</span>
  12593. )
  12594. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  12595. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  12596. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  12597. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  12598. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  12599. }
  12600. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  12601. req, err := http.NewRequest(<span class="hljs-string">&quot;PUT&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/integrations/{int}&quot;</span>, data)
  12602. req.Header = headers
  12603. client := &amp;http.Client{}
  12604. resp, err := client.Do(req)
  12605. <span class="hljs-comment">// ...</span>
  12606. }
  12607. </code></pre>
  12608. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  12609. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  12610. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  12611. );
  12612. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  12613. <span class="hljs-comment">// Define array of request body.</span>
  12614. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  12615. <span class="hljs-keyword">try</span> {
  12616. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;PUT&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}&#x27;</span>, <span class="hljs-keyword">array</span>(
  12617. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  12618. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  12619. )
  12620. );
  12621. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  12622. }
  12623. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  12624. <span class="hljs-comment">// handle exception or api errors.</span>
  12625. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  12626. }
  12627. <span class="hljs-comment">// ...</span>
  12628. </code></pre>
  12629. <p><code>PUT /api/boards/{board}/integrations/{int}</code></p>
  12630. <p><em>Edit integration data</em></p>
  12631. <blockquote>
  12632. <p>Body parameter</p>
  12633. </blockquote>
  12634. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">enabled:</span> <span class="hljs-string">string</span>
  12635. <span class="hljs-attr">title:</span> <span class="hljs-string">string</span>
  12636. <span class="hljs-attr">url:</span> <span class="hljs-string">string</span>
  12637. <span class="hljs-attr">token:</span> <span class="hljs-string">string</span>
  12638. <span class="hljs-attr">activities:</span> <span class="hljs-string">string</span>
  12639. </code></pre>
  12640. <h3 id="edit_integration-parameters">Parameters</h3>
  12641. <table>
  12642. <thead>
  12643. <tr>
  12644. <th>Name</th>
  12645. <th>In</th>
  12646. <th>Type</th>
  12647. <th>Required</th>
  12648. <th>Description</th>
  12649. </tr>
  12650. </thead>
  12651. <tbody>
  12652. <tr>
  12653. <td>board</td>
  12654. <td>path</td>
  12655. <td>string</td>
  12656. <td>true</td>
  12657. <td>the board ID</td>
  12658. </tr>
  12659. <tr>
  12660. <td>int</td>
  12661. <td>path</td>
  12662. <td>string</td>
  12663. <td>true</td>
  12664. <td>the integration ID</td>
  12665. </tr>
  12666. <tr>
  12667. <td>body</td>
  12668. <td>body</td>
  12669. <td>object</td>
  12670. <td>false</td>
  12671. <td>none</td>
  12672. </tr>
  12673. <tr>
  12674. <td>» enabled</td>
  12675. <td>body</td>
  12676. <td>string</td>
  12677. <td>false</td>
  12678. <td>is the integration enabled?</td>
  12679. </tr>
  12680. <tr>
  12681. <td>» title</td>
  12682. <td>body</td>
  12683. <td>string</td>
  12684. <td>false</td>
  12685. <td>new name of the integration</td>
  12686. </tr>
  12687. <tr>
  12688. <td>» url</td>
  12689. <td>body</td>
  12690. <td>string</td>
  12691. <td>false</td>
  12692. <td>new URL of the integration</td>
  12693. </tr>
  12694. <tr>
  12695. <td>» token</td>
  12696. <td>body</td>
  12697. <td>string</td>
  12698. <td>false</td>
  12699. <td>new token of the integration</td>
  12700. </tr>
  12701. <tr>
  12702. <td>» activities</td>
  12703. <td>body</td>
  12704. <td>string</td>
  12705. <td>false</td>
  12706. <td>new list of activities of the integration</td>
  12707. </tr>
  12708. </tbody>
  12709. </table>
  12710. <h4 id="detailed-descriptions-36">Detailed descriptions</h4>
  12711. <p><strong>board</strong>: the board ID</p>
  12712. <p><strong>int</strong>: the integration ID</p>
  12713. <blockquote>
  12714. <p>Example responses</p>
  12715. </blockquote>
  12716. <blockquote>
  12717. <p>200 Response</p>
  12718. </blockquote>
  12719. <pre class="highlight tab tab-json"><code>{
  12720. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  12721. }
  12722. </code></pre>
  12723. <h3 id="edit_integration-responses">Responses</h3>
  12724. <table>
  12725. <thead>
  12726. <tr>
  12727. <th>Status</th>
  12728. <th>Meaning</th>
  12729. <th>Description</th>
  12730. <th>Schema</th>
  12731. </tr>
  12732. </thead>
  12733. <tbody>
  12734. <tr>
  12735. <td>200</td>
  12736. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  12737. <td>200 response</td>
  12738. <td>Inline</td>
  12739. </tr>
  12740. </tbody>
  12741. </table>
  12742. <h3 id="edit_integration-responseschema">Response Schema</h3>
  12743. <p>Status Code <strong>200</strong></p>
  12744. <table>
  12745. <thead>
  12746. <tr>
  12747. <th>Name</th>
  12748. <th>Type</th>
  12749. <th>Required</th>
  12750. <th>Restrictions</th>
  12751. <th>Description</th>
  12752. </tr>
  12753. </thead>
  12754. <tbody>
  12755. <tr>
  12756. <td>» _id</td>
  12757. <td>string</td>
  12758. <td>false</td>
  12759. <td>none</td>
  12760. <td>none</td>
  12761. </tr>
  12762. </tbody>
  12763. </table>
  12764. <aside class="warning">
  12765. To perform this operation, you must be authenticated by means of one of the following methods:
  12766. UserSecurity
  12767. </aside>
  12768. <h2 id="delete_integration">delete_integration</h2>
  12769. <p><a id="opIddelete_integration"></a></p>
  12770. <blockquote>
  12771. <p>Code samples</p>
  12772. </blockquote>
  12773. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  12774. curl -X DELETE /api/boards/{board}/integrations/{int} \
  12775. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  12776. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  12777. </code></pre>
  12778. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">DELETE</span> <span class="hljs-string">/api/boards/{board}/integrations/{int}</span> <span class="hljs-meta">HTTP/1.1</span>
  12779. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  12780. </span></code></pre>
  12781. <pre class="highlight tab tab-javascript"><code>
  12782. <span class="hljs-keyword">const</span> headers = {
  12783. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  12784. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  12785. };
  12786. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}&#x27;</span>,
  12787. {
  12788. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  12789. <span class="hljs-attr">headers</span>: headers
  12790. })
  12791. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  12792. <span class="hljs-keyword">return</span> res.json();
  12793. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  12794. <span class="hljs-built_in">console</span>.log(body);
  12795. });
  12796. </code></pre>
  12797. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  12798. <span class="hljs-keyword">const</span> headers = {
  12799. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  12800. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  12801. };
  12802. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}&#x27;</span>,
  12803. {
  12804. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  12805. <span class="hljs-attr">headers</span>: headers
  12806. })
  12807. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  12808. <span class="hljs-keyword">return</span> res.json();
  12809. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  12810. <span class="hljs-built_in">console</span>.log(body);
  12811. });
  12812. </code></pre>
  12813. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  12814. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  12815. headers = {
  12816. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  12817. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  12818. }
  12819. result = RestClient.delete <span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}&#x27;</span>,
  12820. <span class="hljs-symbol">params:</span> {
  12821. }, <span class="hljs-symbol">headers:</span> headers
  12822. p JSON.parse(result)
  12823. </code></pre>
  12824. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  12825. headers = {
  12826. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  12827. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  12828. }
  12829. r = requests.delete(<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}&#x27;</span>, headers = headers)
  12830. <span class="hljs-built_in">print</span>(r.json())
  12831. </code></pre>
  12832. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/integrations/{int}&quot;</span>);
  12833. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  12834. con.setRequestMethod(<span class="hljs-string">&quot;DELETE&quot;</span>);
  12835. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  12836. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  12837. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  12838. String inputLine;
  12839. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  12840. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  12841. response.append(inputLine);
  12842. }
  12843. in.close();
  12844. System.out.println(response.toString());
  12845. </code></pre>
  12846. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  12847. <span class="hljs-keyword">import</span> (
  12848. <span class="hljs-string">&quot;bytes&quot;</span>
  12849. <span class="hljs-string">&quot;net/http&quot;</span>
  12850. )
  12851. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  12852. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  12853. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  12854. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  12855. }
  12856. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  12857. req, err := http.NewRequest(<span class="hljs-string">&quot;DELETE&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/integrations/{int}&quot;</span>, data)
  12858. req.Header = headers
  12859. client := &amp;http.Client{}
  12860. resp, err := client.Do(req)
  12861. <span class="hljs-comment">// ...</span>
  12862. }
  12863. </code></pre>
  12864. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  12865. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  12866. );
  12867. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  12868. <span class="hljs-comment">// Define array of request body.</span>
  12869. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  12870. <span class="hljs-keyword">try</span> {
  12871. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;DELETE&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}&#x27;</span>, <span class="hljs-keyword">array</span>(
  12872. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  12873. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  12874. )
  12875. );
  12876. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  12877. }
  12878. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  12879. <span class="hljs-comment">// handle exception or api errors.</span>
  12880. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  12881. }
  12882. <span class="hljs-comment">// ...</span>
  12883. </code></pre>
  12884. <p><code>DELETE /api/boards/{board}/integrations/{int}</code></p>
  12885. <p><em>Delete integration</em></p>
  12886. <h3 id="delete_integration-parameters">Parameters</h3>
  12887. <table>
  12888. <thead>
  12889. <tr>
  12890. <th>Name</th>
  12891. <th>In</th>
  12892. <th>Type</th>
  12893. <th>Required</th>
  12894. <th>Description</th>
  12895. </tr>
  12896. </thead>
  12897. <tbody>
  12898. <tr>
  12899. <td>board</td>
  12900. <td>path</td>
  12901. <td>string</td>
  12902. <td>true</td>
  12903. <td>the board ID</td>
  12904. </tr>
  12905. <tr>
  12906. <td>int</td>
  12907. <td>path</td>
  12908. <td>string</td>
  12909. <td>true</td>
  12910. <td>the integration ID</td>
  12911. </tr>
  12912. </tbody>
  12913. </table>
  12914. <h4 id="detailed-descriptions-37">Detailed descriptions</h4>
  12915. <p><strong>board</strong>: the board ID</p>
  12916. <p><strong>int</strong>: the integration ID</p>
  12917. <blockquote>
  12918. <p>Example responses</p>
  12919. </blockquote>
  12920. <blockquote>
  12921. <p>200 Response</p>
  12922. </blockquote>
  12923. <pre class="highlight tab tab-json"><code>{
  12924. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  12925. }
  12926. </code></pre>
  12927. <h3 id="delete_integration-responses">Responses</h3>
  12928. <table>
  12929. <thead>
  12930. <tr>
  12931. <th>Status</th>
  12932. <th>Meaning</th>
  12933. <th>Description</th>
  12934. <th>Schema</th>
  12935. </tr>
  12936. </thead>
  12937. <tbody>
  12938. <tr>
  12939. <td>200</td>
  12940. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  12941. <td>200 response</td>
  12942. <td>Inline</td>
  12943. </tr>
  12944. </tbody>
  12945. </table>
  12946. <h3 id="delete_integration-responseschema">Response Schema</h3>
  12947. <p>Status Code <strong>200</strong></p>
  12948. <table>
  12949. <thead>
  12950. <tr>
  12951. <th>Name</th>
  12952. <th>Type</th>
  12953. <th>Required</th>
  12954. <th>Restrictions</th>
  12955. <th>Description</th>
  12956. </tr>
  12957. </thead>
  12958. <tbody>
  12959. <tr>
  12960. <td>» _id</td>
  12961. <td>string</td>
  12962. <td>false</td>
  12963. <td>none</td>
  12964. <td>none</td>
  12965. </tr>
  12966. </tbody>
  12967. </table>
  12968. <aside class="warning">
  12969. To perform this operation, you must be authenticated by means of one of the following methods:
  12970. UserSecurity
  12971. </aside>
  12972. <h2 id="delete_integration_activities">delete_integration_activities</h2>
  12973. <p><a id="opIddelete_integration_activities"></a></p>
  12974. <blockquote>
  12975. <p>Code samples</p>
  12976. </blockquote>
  12977. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  12978. curl -X DELETE /api/boards/{board}/integrations/{int}/activities \
  12979. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  12980. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  12981. </code></pre>
  12982. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">DELETE</span> <span class="hljs-string">/api/boards/{board}/integrations/{int}/activities</span> <span class="hljs-meta">HTTP/1.1</span>
  12983. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  12984. </span></code></pre>
  12985. <pre class="highlight tab tab-javascript"><code>
  12986. <span class="hljs-keyword">const</span> headers = {
  12987. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  12988. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  12989. };
  12990. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}/activities&#x27;</span>,
  12991. {
  12992. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  12993. <span class="hljs-attr">headers</span>: headers
  12994. })
  12995. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  12996. <span class="hljs-keyword">return</span> res.json();
  12997. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  12998. <span class="hljs-built_in">console</span>.log(body);
  12999. });
  13000. </code></pre>
  13001. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  13002. <span class="hljs-keyword">const</span> headers = {
  13003. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  13004. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13005. };
  13006. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}/activities&#x27;</span>,
  13007. {
  13008. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  13009. <span class="hljs-attr">headers</span>: headers
  13010. })
  13011. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  13012. <span class="hljs-keyword">return</span> res.json();
  13013. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  13014. <span class="hljs-built_in">console</span>.log(body);
  13015. });
  13016. </code></pre>
  13017. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  13018. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  13019. headers = {
  13020. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  13021. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13022. }
  13023. result = RestClient.delete <span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}/activities&#x27;</span>,
  13024. <span class="hljs-symbol">params:</span> {
  13025. }, <span class="hljs-symbol">headers:</span> headers
  13026. p JSON.parse(result)
  13027. </code></pre>
  13028. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  13029. headers = {
  13030. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  13031. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13032. }
  13033. r = requests.delete(<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}/activities&#x27;</span>, headers = headers)
  13034. <span class="hljs-built_in">print</span>(r.json())
  13035. </code></pre>
  13036. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/integrations/{int}/activities&quot;</span>);
  13037. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  13038. con.setRequestMethod(<span class="hljs-string">&quot;DELETE&quot;</span>);
  13039. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  13040. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  13041. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  13042. String inputLine;
  13043. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  13044. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  13045. response.append(inputLine);
  13046. }
  13047. in.close();
  13048. System.out.println(response.toString());
  13049. </code></pre>
  13050. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  13051. <span class="hljs-keyword">import</span> (
  13052. <span class="hljs-string">&quot;bytes&quot;</span>
  13053. <span class="hljs-string">&quot;net/http&quot;</span>
  13054. )
  13055. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  13056. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  13057. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  13058. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  13059. }
  13060. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  13061. req, err := http.NewRequest(<span class="hljs-string">&quot;DELETE&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/integrations/{int}/activities&quot;</span>, data)
  13062. req.Header = headers
  13063. client := &amp;http.Client{}
  13064. resp, err := client.Do(req)
  13065. <span class="hljs-comment">// ...</span>
  13066. }
  13067. </code></pre>
  13068. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  13069. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  13070. );
  13071. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  13072. <span class="hljs-comment">// Define array of request body.</span>
  13073. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  13074. <span class="hljs-keyword">try</span> {
  13075. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;DELETE&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}/activities&#x27;</span>, <span class="hljs-keyword">array</span>(
  13076. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  13077. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  13078. )
  13079. );
  13080. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  13081. }
  13082. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  13083. <span class="hljs-comment">// handle exception or api errors.</span>
  13084. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  13085. }
  13086. <span class="hljs-comment">// ...</span>
  13087. </code></pre>
  13088. <p><code>DELETE /api/boards/{board}/integrations/{int}/activities</code></p>
  13089. <p><em>Delete subscribed activities</em></p>
  13090. <h3 id="delete_integration_activities-parameters">Parameters</h3>
  13091. <table>
  13092. <thead>
  13093. <tr>
  13094. <th>Name</th>
  13095. <th>In</th>
  13096. <th>Type</th>
  13097. <th>Required</th>
  13098. <th>Description</th>
  13099. </tr>
  13100. </thead>
  13101. <tbody>
  13102. <tr>
  13103. <td>board</td>
  13104. <td>path</td>
  13105. <td>string</td>
  13106. <td>true</td>
  13107. <td>the board ID</td>
  13108. </tr>
  13109. <tr>
  13110. <td>int</td>
  13111. <td>path</td>
  13112. <td>string</td>
  13113. <td>true</td>
  13114. <td>the integration ID</td>
  13115. </tr>
  13116. </tbody>
  13117. </table>
  13118. <h4 id="detailed-descriptions-38">Detailed descriptions</h4>
  13119. <p><strong>board</strong>: the board ID</p>
  13120. <p><strong>int</strong>: the integration ID</p>
  13121. <blockquote>
  13122. <p>Example responses</p>
  13123. </blockquote>
  13124. <blockquote>
  13125. <p>200 Response</p>
  13126. </blockquote>
  13127. <pre class="highlight tab tab-json"><code>{
  13128. <span class="hljs-attr">&quot;enabled&quot;</span>: <span class="hljs-literal">true</span>,
  13129. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13130. <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13131. <span class="hljs-attr">&quot;activities&quot;</span>: [
  13132. <span class="hljs-string">&quot;string&quot;</span>
  13133. ],
  13134. <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13135. <span class="hljs-attr">&quot;token&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13136. <span class="hljs-attr">&quot;boardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13137. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13138. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13139. <span class="hljs-attr">&quot;userId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  13140. }
  13141. </code></pre>
  13142. <h3 id="delete_integration_activities-responses">Responses</h3>
  13143. <table>
  13144. <thead>
  13145. <tr>
  13146. <th>Status</th>
  13147. <th>Meaning</th>
  13148. <th>Description</th>
  13149. <th>Schema</th>
  13150. </tr>
  13151. </thead>
  13152. <tbody>
  13153. <tr>
  13154. <td>200</td>
  13155. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  13156. <td>200 response</td>
  13157. <td><a href="#schemaintegrations">Integrations</a></td>
  13158. </tr>
  13159. </tbody>
  13160. </table>
  13161. <aside class="warning">
  13162. To perform this operation, you must be authenticated by means of one of the following methods:
  13163. UserSecurity
  13164. </aside>
  13165. <h2 id="new_integration_activities">new_integration_activities</h2>
  13166. <p><a id="opIdnew_integration_activities"></a></p>
  13167. <blockquote>
  13168. <p>Code samples</p>
  13169. </blockquote>
  13170. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  13171. curl -X POST /api/boards/{board}/integrations/{int}/activities \
  13172. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  13173. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  13174. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  13175. </code></pre>
  13176. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/boards/{board}/integrations/{int}/activities</span> <span class="hljs-meta">HTTP/1.1</span>
  13177. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  13178. Accept: application/json
  13179. </span></code></pre>
  13180. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  13181. &quot;activities&quot;: &quot;string&quot;
  13182. }&#x27;</span>;
  13183. <span class="hljs-keyword">const</span> headers = {
  13184. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  13185. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  13186. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13187. };
  13188. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}/activities&#x27;</span>,
  13189. {
  13190. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  13191. <span class="hljs-attr">body</span>: inputBody,
  13192. <span class="hljs-attr">headers</span>: headers
  13193. })
  13194. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  13195. <span class="hljs-keyword">return</span> res.json();
  13196. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  13197. <span class="hljs-built_in">console</span>.log(body);
  13198. });
  13199. </code></pre>
  13200. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  13201. <span class="hljs-keyword">const</span> inputBody = {
  13202. <span class="hljs-string">&quot;activities&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  13203. };
  13204. <span class="hljs-keyword">const</span> headers = {
  13205. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  13206. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  13207. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13208. };
  13209. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}/activities&#x27;</span>,
  13210. {
  13211. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  13212. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  13213. <span class="hljs-attr">headers</span>: headers
  13214. })
  13215. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  13216. <span class="hljs-keyword">return</span> res.json();
  13217. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  13218. <span class="hljs-built_in">console</span>.log(body);
  13219. });
  13220. </code></pre>
  13221. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  13222. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  13223. headers = {
  13224. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  13225. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  13226. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13227. }
  13228. result = RestClient.post <span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}/activities&#x27;</span>,
  13229. <span class="hljs-symbol">params:</span> {
  13230. }, <span class="hljs-symbol">headers:</span> headers
  13231. p JSON.parse(result)
  13232. </code></pre>
  13233. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  13234. headers = {
  13235. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  13236. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  13237. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13238. }
  13239. r = requests.post(<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}/activities&#x27;</span>, headers = headers)
  13240. <span class="hljs-built_in">print</span>(r.json())
  13241. </code></pre>
  13242. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/integrations/{int}/activities&quot;</span>);
  13243. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  13244. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  13245. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  13246. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  13247. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  13248. String inputLine;
  13249. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  13250. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  13251. response.append(inputLine);
  13252. }
  13253. in.close();
  13254. System.out.println(response.toString());
  13255. </code></pre>
  13256. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  13257. <span class="hljs-keyword">import</span> (
  13258. <span class="hljs-string">&quot;bytes&quot;</span>
  13259. <span class="hljs-string">&quot;net/http&quot;</span>
  13260. )
  13261. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  13262. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  13263. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  13264. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  13265. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  13266. }
  13267. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  13268. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/integrations/{int}/activities&quot;</span>, data)
  13269. req.Header = headers
  13270. client := &amp;http.Client{}
  13271. resp, err := client.Do(req)
  13272. <span class="hljs-comment">// ...</span>
  13273. }
  13274. </code></pre>
  13275. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  13276. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  13277. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  13278. );
  13279. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  13280. <span class="hljs-comment">// Define array of request body.</span>
  13281. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  13282. <span class="hljs-keyword">try</span> {
  13283. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/integrations/{int}/activities&#x27;</span>, <span class="hljs-keyword">array</span>(
  13284. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  13285. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  13286. )
  13287. );
  13288. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  13289. }
  13290. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  13291. <span class="hljs-comment">// handle exception or api errors.</span>
  13292. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  13293. }
  13294. <span class="hljs-comment">// ...</span>
  13295. </code></pre>
  13296. <p><code>POST /api/boards/{board}/integrations/{int}/activities</code></p>
  13297. <p><em>Add subscribed activities</em></p>
  13298. <blockquote>
  13299. <p>Body parameter</p>
  13300. </blockquote>
  13301. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">activities:</span> <span class="hljs-string">string</span>
  13302. </code></pre>
  13303. <h3 id="new_integration_activities-parameters">Parameters</h3>
  13304. <table>
  13305. <thead>
  13306. <tr>
  13307. <th>Name</th>
  13308. <th>In</th>
  13309. <th>Type</th>
  13310. <th>Required</th>
  13311. <th>Description</th>
  13312. </tr>
  13313. </thead>
  13314. <tbody>
  13315. <tr>
  13316. <td>board</td>
  13317. <td>path</td>
  13318. <td>string</td>
  13319. <td>true</td>
  13320. <td>the board ID</td>
  13321. </tr>
  13322. <tr>
  13323. <td>int</td>
  13324. <td>path</td>
  13325. <td>string</td>
  13326. <td>true</td>
  13327. <td>the integration ID</td>
  13328. </tr>
  13329. <tr>
  13330. <td>body</td>
  13331. <td>body</td>
  13332. <td>object</td>
  13333. <td>true</td>
  13334. <td>none</td>
  13335. </tr>
  13336. <tr>
  13337. <td>» activities</td>
  13338. <td>body</td>
  13339. <td>string</td>
  13340. <td>true</td>
  13341. <td>the activities value</td>
  13342. </tr>
  13343. </tbody>
  13344. </table>
  13345. <h4 id="detailed-descriptions-39">Detailed descriptions</h4>
  13346. <p><strong>board</strong>: the board ID</p>
  13347. <p><strong>int</strong>: the integration ID</p>
  13348. <blockquote>
  13349. <p>Example responses</p>
  13350. </blockquote>
  13351. <blockquote>
  13352. <p>200 Response</p>
  13353. </blockquote>
  13354. <pre class="highlight tab tab-json"><code>{
  13355. <span class="hljs-attr">&quot;enabled&quot;</span>: <span class="hljs-literal">true</span>,
  13356. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13357. <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13358. <span class="hljs-attr">&quot;activities&quot;</span>: [
  13359. <span class="hljs-string">&quot;string&quot;</span>
  13360. ],
  13361. <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13362. <span class="hljs-attr">&quot;token&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13363. <span class="hljs-attr">&quot;boardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13364. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13365. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13366. <span class="hljs-attr">&quot;userId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  13367. }
  13368. </code></pre>
  13369. <h3 id="new_integration_activities-responses">Responses</h3>
  13370. <table>
  13371. <thead>
  13372. <tr>
  13373. <th>Status</th>
  13374. <th>Meaning</th>
  13375. <th>Description</th>
  13376. <th>Schema</th>
  13377. </tr>
  13378. </thead>
  13379. <tbody>
  13380. <tr>
  13381. <td>200</td>
  13382. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  13383. <td>200 response</td>
  13384. <td><a href="#schemaintegrations">Integrations</a></td>
  13385. </tr>
  13386. </tbody>
  13387. </table>
  13388. <aside class="warning">
  13389. To perform this operation, you must be authenticated by means of one of the following methods:
  13390. UserSecurity
  13391. </aside>
  13392. <h1 id="wekan-rest-api-lists">Lists</h1>
  13393. <h2 id="get_all_lists">get_all_lists</h2>
  13394. <p><a id="opIdget_all_lists"></a></p>
  13395. <blockquote>
  13396. <p>Code samples</p>
  13397. </blockquote>
  13398. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  13399. curl -X GET /api/boards/{board}/lists \
  13400. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  13401. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  13402. </code></pre>
  13403. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/lists</span> <span class="hljs-meta">HTTP/1.1</span>
  13404. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  13405. </span></code></pre>
  13406. <pre class="highlight tab tab-javascript"><code>
  13407. <span class="hljs-keyword">const</span> headers = {
  13408. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  13409. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13410. };
  13411. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists&#x27;</span>,
  13412. {
  13413. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  13414. <span class="hljs-attr">headers</span>: headers
  13415. })
  13416. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  13417. <span class="hljs-keyword">return</span> res.json();
  13418. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  13419. <span class="hljs-built_in">console</span>.log(body);
  13420. });
  13421. </code></pre>
  13422. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  13423. <span class="hljs-keyword">const</span> headers = {
  13424. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  13425. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13426. };
  13427. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists&#x27;</span>,
  13428. {
  13429. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  13430. <span class="hljs-attr">headers</span>: headers
  13431. })
  13432. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  13433. <span class="hljs-keyword">return</span> res.json();
  13434. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  13435. <span class="hljs-built_in">console</span>.log(body);
  13436. });
  13437. </code></pre>
  13438. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  13439. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  13440. headers = {
  13441. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  13442. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13443. }
  13444. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/lists&#x27;</span>,
  13445. <span class="hljs-symbol">params:</span> {
  13446. }, <span class="hljs-symbol">headers:</span> headers
  13447. p JSON.parse(result)
  13448. </code></pre>
  13449. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  13450. headers = {
  13451. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  13452. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13453. }
  13454. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/lists&#x27;</span>, headers = headers)
  13455. <span class="hljs-built_in">print</span>(r.json())
  13456. </code></pre>
  13457. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/lists&quot;</span>);
  13458. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  13459. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  13460. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  13461. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  13462. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  13463. String inputLine;
  13464. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  13465. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  13466. response.append(inputLine);
  13467. }
  13468. in.close();
  13469. System.out.println(response.toString());
  13470. </code></pre>
  13471. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  13472. <span class="hljs-keyword">import</span> (
  13473. <span class="hljs-string">&quot;bytes&quot;</span>
  13474. <span class="hljs-string">&quot;net/http&quot;</span>
  13475. )
  13476. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  13477. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  13478. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  13479. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  13480. }
  13481. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  13482. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/lists&quot;</span>, data)
  13483. req.Header = headers
  13484. client := &amp;http.Client{}
  13485. resp, err := client.Do(req)
  13486. <span class="hljs-comment">// ...</span>
  13487. }
  13488. </code></pre>
  13489. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  13490. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  13491. );
  13492. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  13493. <span class="hljs-comment">// Define array of request body.</span>
  13494. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  13495. <span class="hljs-keyword">try</span> {
  13496. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/lists&#x27;</span>, <span class="hljs-keyword">array</span>(
  13497. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  13498. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  13499. )
  13500. );
  13501. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  13502. }
  13503. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  13504. <span class="hljs-comment">// handle exception or api errors.</span>
  13505. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  13506. }
  13507. <span class="hljs-comment">// ...</span>
  13508. </code></pre>
  13509. <p><code>GET /api/boards/{board}/lists</code></p>
  13510. <p><em>Get the list of Lists attached to a board</em></p>
  13511. <h3 id="get_all_lists-parameters">Parameters</h3>
  13512. <table>
  13513. <thead>
  13514. <tr>
  13515. <th>Name</th>
  13516. <th>In</th>
  13517. <th>Type</th>
  13518. <th>Required</th>
  13519. <th>Description</th>
  13520. </tr>
  13521. </thead>
  13522. <tbody>
  13523. <tr>
  13524. <td>board</td>
  13525. <td>path</td>
  13526. <td>string</td>
  13527. <td>true</td>
  13528. <td>the board ID</td>
  13529. </tr>
  13530. </tbody>
  13531. </table>
  13532. <h4 id="detailed-descriptions-40">Detailed descriptions</h4>
  13533. <p><strong>board</strong>: the board ID</p>
  13534. <blockquote>
  13535. <p>Example responses</p>
  13536. </blockquote>
  13537. <blockquote>
  13538. <p>200 Response</p>
  13539. </blockquote>
  13540. <pre class="highlight tab tab-json"><code>[
  13541. {
  13542. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13543. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  13544. }
  13545. ]
  13546. </code></pre>
  13547. <h3 id="get_all_lists-responses">Responses</h3>
  13548. <table>
  13549. <thead>
  13550. <tr>
  13551. <th>Status</th>
  13552. <th>Meaning</th>
  13553. <th>Description</th>
  13554. <th>Schema</th>
  13555. </tr>
  13556. </thead>
  13557. <tbody>
  13558. <tr>
  13559. <td>200</td>
  13560. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  13561. <td>200 response</td>
  13562. <td>Inline</td>
  13563. </tr>
  13564. </tbody>
  13565. </table>
  13566. <h3 id="get_all_lists-responseschema">Response Schema</h3>
  13567. <p>Status Code <strong>200</strong></p>
  13568. <table>
  13569. <thead>
  13570. <tr>
  13571. <th>Name</th>
  13572. <th>Type</th>
  13573. <th>Required</th>
  13574. <th>Restrictions</th>
  13575. <th>Description</th>
  13576. </tr>
  13577. </thead>
  13578. <tbody>
  13579. <tr>
  13580. <td>» _id</td>
  13581. <td>string</td>
  13582. <td>false</td>
  13583. <td>none</td>
  13584. <td>none</td>
  13585. </tr>
  13586. <tr>
  13587. <td>» title</td>
  13588. <td>string</td>
  13589. <td>false</td>
  13590. <td>none</td>
  13591. <td>none</td>
  13592. </tr>
  13593. </tbody>
  13594. </table>
  13595. <aside class="warning">
  13596. To perform this operation, you must be authenticated by means of one of the following methods:
  13597. UserSecurity
  13598. </aside>
  13599. <h2 id="new_list">new_list</h2>
  13600. <p><a id="opIdnew_list"></a></p>
  13601. <blockquote>
  13602. <p>Code samples</p>
  13603. </blockquote>
  13604. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  13605. curl -X POST /api/boards/{board}/lists \
  13606. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  13607. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  13608. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  13609. </code></pre>
  13610. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/boards/{board}/lists</span> <span class="hljs-meta">HTTP/1.1</span>
  13611. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  13612. Accept: application/json
  13613. </span></code></pre>
  13614. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  13615. &quot;title&quot;: &quot;string&quot;
  13616. }&#x27;</span>;
  13617. <span class="hljs-keyword">const</span> headers = {
  13618. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  13619. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  13620. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13621. };
  13622. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists&#x27;</span>,
  13623. {
  13624. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  13625. <span class="hljs-attr">body</span>: inputBody,
  13626. <span class="hljs-attr">headers</span>: headers
  13627. })
  13628. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  13629. <span class="hljs-keyword">return</span> res.json();
  13630. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  13631. <span class="hljs-built_in">console</span>.log(body);
  13632. });
  13633. </code></pre>
  13634. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  13635. <span class="hljs-keyword">const</span> inputBody = {
  13636. <span class="hljs-string">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  13637. };
  13638. <span class="hljs-keyword">const</span> headers = {
  13639. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  13640. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  13641. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13642. };
  13643. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists&#x27;</span>,
  13644. {
  13645. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  13646. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  13647. <span class="hljs-attr">headers</span>: headers
  13648. })
  13649. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  13650. <span class="hljs-keyword">return</span> res.json();
  13651. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  13652. <span class="hljs-built_in">console</span>.log(body);
  13653. });
  13654. </code></pre>
  13655. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  13656. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  13657. headers = {
  13658. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  13659. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  13660. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13661. }
  13662. result = RestClient.post <span class="hljs-string">&#x27;/api/boards/{board}/lists&#x27;</span>,
  13663. <span class="hljs-symbol">params:</span> {
  13664. }, <span class="hljs-symbol">headers:</span> headers
  13665. p JSON.parse(result)
  13666. </code></pre>
  13667. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  13668. headers = {
  13669. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  13670. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  13671. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13672. }
  13673. r = requests.post(<span class="hljs-string">&#x27;/api/boards/{board}/lists&#x27;</span>, headers = headers)
  13674. <span class="hljs-built_in">print</span>(r.json())
  13675. </code></pre>
  13676. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/lists&quot;</span>);
  13677. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  13678. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  13679. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  13680. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  13681. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  13682. String inputLine;
  13683. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  13684. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  13685. response.append(inputLine);
  13686. }
  13687. in.close();
  13688. System.out.println(response.toString());
  13689. </code></pre>
  13690. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  13691. <span class="hljs-keyword">import</span> (
  13692. <span class="hljs-string">&quot;bytes&quot;</span>
  13693. <span class="hljs-string">&quot;net/http&quot;</span>
  13694. )
  13695. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  13696. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  13697. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  13698. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  13699. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  13700. }
  13701. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  13702. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/lists&quot;</span>, data)
  13703. req.Header = headers
  13704. client := &amp;http.Client{}
  13705. resp, err := client.Do(req)
  13706. <span class="hljs-comment">// ...</span>
  13707. }
  13708. </code></pre>
  13709. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  13710. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  13711. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  13712. );
  13713. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  13714. <span class="hljs-comment">// Define array of request body.</span>
  13715. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  13716. <span class="hljs-keyword">try</span> {
  13717. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/lists&#x27;</span>, <span class="hljs-keyword">array</span>(
  13718. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  13719. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  13720. )
  13721. );
  13722. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  13723. }
  13724. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  13725. <span class="hljs-comment">// handle exception or api errors.</span>
  13726. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  13727. }
  13728. <span class="hljs-comment">// ...</span>
  13729. </code></pre>
  13730. <p><code>POST /api/boards/{board}/lists</code></p>
  13731. <p><em>Add a List to a board</em></p>
  13732. <blockquote>
  13733. <p>Body parameter</p>
  13734. </blockquote>
  13735. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">title:</span> <span class="hljs-string">string</span>
  13736. </code></pre>
  13737. <h3 id="new_list-parameters">Parameters</h3>
  13738. <table>
  13739. <thead>
  13740. <tr>
  13741. <th>Name</th>
  13742. <th>In</th>
  13743. <th>Type</th>
  13744. <th>Required</th>
  13745. <th>Description</th>
  13746. </tr>
  13747. </thead>
  13748. <tbody>
  13749. <tr>
  13750. <td>board</td>
  13751. <td>path</td>
  13752. <td>string</td>
  13753. <td>true</td>
  13754. <td>the board ID</td>
  13755. </tr>
  13756. <tr>
  13757. <td>body</td>
  13758. <td>body</td>
  13759. <td>object</td>
  13760. <td>true</td>
  13761. <td>none</td>
  13762. </tr>
  13763. <tr>
  13764. <td>» title</td>
  13765. <td>body</td>
  13766. <td>string</td>
  13767. <td>true</td>
  13768. <td>the title of the List</td>
  13769. </tr>
  13770. </tbody>
  13771. </table>
  13772. <h4 id="detailed-descriptions-41">Detailed descriptions</h4>
  13773. <p><strong>board</strong>: the board ID</p>
  13774. <blockquote>
  13775. <p>Example responses</p>
  13776. </blockquote>
  13777. <blockquote>
  13778. <p>200 Response</p>
  13779. </blockquote>
  13780. <pre class="highlight tab tab-json"><code>{
  13781. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  13782. }
  13783. </code></pre>
  13784. <h3 id="new_list-responses">Responses</h3>
  13785. <table>
  13786. <thead>
  13787. <tr>
  13788. <th>Status</th>
  13789. <th>Meaning</th>
  13790. <th>Description</th>
  13791. <th>Schema</th>
  13792. </tr>
  13793. </thead>
  13794. <tbody>
  13795. <tr>
  13796. <td>200</td>
  13797. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  13798. <td>200 response</td>
  13799. <td>Inline</td>
  13800. </tr>
  13801. </tbody>
  13802. </table>
  13803. <h3 id="new_list-responseschema">Response Schema</h3>
  13804. <p>Status Code <strong>200</strong></p>
  13805. <table>
  13806. <thead>
  13807. <tr>
  13808. <th>Name</th>
  13809. <th>Type</th>
  13810. <th>Required</th>
  13811. <th>Restrictions</th>
  13812. <th>Description</th>
  13813. </tr>
  13814. </thead>
  13815. <tbody>
  13816. <tr>
  13817. <td>» _id</td>
  13818. <td>string</td>
  13819. <td>false</td>
  13820. <td>none</td>
  13821. <td>none</td>
  13822. </tr>
  13823. </tbody>
  13824. </table>
  13825. <aside class="warning">
  13826. To perform this operation, you must be authenticated by means of one of the following methods:
  13827. UserSecurity
  13828. </aside>
  13829. <h2 id="get_list">get_list</h2>
  13830. <p><a id="opIdget_list"></a></p>
  13831. <blockquote>
  13832. <p>Code samples</p>
  13833. </blockquote>
  13834. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  13835. curl -X GET /api/boards/{board}/lists/{list} \
  13836. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  13837. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  13838. </code></pre>
  13839. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/lists/{list}</span> <span class="hljs-meta">HTTP/1.1</span>
  13840. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  13841. </span></code></pre>
  13842. <pre class="highlight tab tab-javascript"><code>
  13843. <span class="hljs-keyword">const</span> headers = {
  13844. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  13845. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13846. };
  13847. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}&#x27;</span>,
  13848. {
  13849. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  13850. <span class="hljs-attr">headers</span>: headers
  13851. })
  13852. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  13853. <span class="hljs-keyword">return</span> res.json();
  13854. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  13855. <span class="hljs-built_in">console</span>.log(body);
  13856. });
  13857. </code></pre>
  13858. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  13859. <span class="hljs-keyword">const</span> headers = {
  13860. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  13861. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13862. };
  13863. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}&#x27;</span>,
  13864. {
  13865. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  13866. <span class="hljs-attr">headers</span>: headers
  13867. })
  13868. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  13869. <span class="hljs-keyword">return</span> res.json();
  13870. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  13871. <span class="hljs-built_in">console</span>.log(body);
  13872. });
  13873. </code></pre>
  13874. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  13875. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  13876. headers = {
  13877. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  13878. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13879. }
  13880. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}&#x27;</span>,
  13881. <span class="hljs-symbol">params:</span> {
  13882. }, <span class="hljs-symbol">headers:</span> headers
  13883. p JSON.parse(result)
  13884. </code></pre>
  13885. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  13886. headers = {
  13887. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  13888. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  13889. }
  13890. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}&#x27;</span>, headers = headers)
  13891. <span class="hljs-built_in">print</span>(r.json())
  13892. </code></pre>
  13893. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/lists/{list}&quot;</span>);
  13894. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  13895. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  13896. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  13897. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  13898. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  13899. String inputLine;
  13900. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  13901. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  13902. response.append(inputLine);
  13903. }
  13904. in.close();
  13905. System.out.println(response.toString());
  13906. </code></pre>
  13907. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  13908. <span class="hljs-keyword">import</span> (
  13909. <span class="hljs-string">&quot;bytes&quot;</span>
  13910. <span class="hljs-string">&quot;net/http&quot;</span>
  13911. )
  13912. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  13913. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  13914. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  13915. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  13916. }
  13917. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  13918. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/lists/{list}&quot;</span>, data)
  13919. req.Header = headers
  13920. client := &amp;http.Client{}
  13921. resp, err := client.Do(req)
  13922. <span class="hljs-comment">// ...</span>
  13923. }
  13924. </code></pre>
  13925. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  13926. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  13927. );
  13928. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  13929. <span class="hljs-comment">// Define array of request body.</span>
  13930. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  13931. <span class="hljs-keyword">try</span> {
  13932. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}&#x27;</span>, <span class="hljs-keyword">array</span>(
  13933. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  13934. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  13935. )
  13936. );
  13937. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  13938. }
  13939. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  13940. <span class="hljs-comment">// handle exception or api errors.</span>
  13941. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  13942. }
  13943. <span class="hljs-comment">// ...</span>
  13944. </code></pre>
  13945. <p><code>GET /api/boards/{board}/lists/{list}</code></p>
  13946. <p><em>Get a List attached to a board</em></p>
  13947. <h3 id="get_list-parameters">Parameters</h3>
  13948. <table>
  13949. <thead>
  13950. <tr>
  13951. <th>Name</th>
  13952. <th>In</th>
  13953. <th>Type</th>
  13954. <th>Required</th>
  13955. <th>Description</th>
  13956. </tr>
  13957. </thead>
  13958. <tbody>
  13959. <tr>
  13960. <td>board</td>
  13961. <td>path</td>
  13962. <td>string</td>
  13963. <td>true</td>
  13964. <td>the board ID</td>
  13965. </tr>
  13966. <tr>
  13967. <td>list</td>
  13968. <td>path</td>
  13969. <td>string</td>
  13970. <td>true</td>
  13971. <td>the List ID</td>
  13972. </tr>
  13973. </tbody>
  13974. </table>
  13975. <h4 id="detailed-descriptions-42">Detailed descriptions</h4>
  13976. <p><strong>board</strong>: the board ID</p>
  13977. <p><strong>list</strong>: the List ID</p>
  13978. <blockquote>
  13979. <p>Example responses</p>
  13980. </blockquote>
  13981. <blockquote>
  13982. <p>200 Response</p>
  13983. </blockquote>
  13984. <pre class="highlight tab tab-json"><code>{
  13985. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13986. <span class="hljs-attr">&quot;starred&quot;</span>: <span class="hljs-literal">true</span>,
  13987. <span class="hljs-attr">&quot;archived&quot;</span>: <span class="hljs-literal">true</span>,
  13988. <span class="hljs-attr">&quot;archivedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13989. <span class="hljs-attr">&quot;boardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13990. <span class="hljs-attr">&quot;swimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13991. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13992. <span class="hljs-attr">&quot;sort&quot;</span>: <span class="hljs-number">0</span>,
  13993. <span class="hljs-attr">&quot;width&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13994. <span class="hljs-attr">&quot;height&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13995. <span class="hljs-attr">&quot;updatedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13996. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  13997. <span class="hljs-attr">&quot;wipLimit&quot;</span>: {
  13998. <span class="hljs-attr">&quot;value&quot;</span>: <span class="hljs-number">0</span>,
  13999. <span class="hljs-attr">&quot;enabled&quot;</span>: <span class="hljs-literal">true</span>,
  14000. <span class="hljs-attr">&quot;soft&quot;</span>: <span class="hljs-literal">true</span>
  14001. },
  14002. <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;white&quot;</span>,
  14003. <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  14004. }
  14005. </code></pre>
  14006. <h3 id="get_list-responses">Responses</h3>
  14007. <table>
  14008. <thead>
  14009. <tr>
  14010. <th>Status</th>
  14011. <th>Meaning</th>
  14012. <th>Description</th>
  14013. <th>Schema</th>
  14014. </tr>
  14015. </thead>
  14016. <tbody>
  14017. <tr>
  14018. <td>200</td>
  14019. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  14020. <td>200 response</td>
  14021. <td><a href="#schemalists">Lists</a></td>
  14022. </tr>
  14023. </tbody>
  14024. </table>
  14025. <aside class="warning">
  14026. To perform this operation, you must be authenticated by means of one of the following methods:
  14027. UserSecurity
  14028. </aside>
  14029. <h2 id="delete_list">delete_list</h2>
  14030. <p><a id="opIddelete_list"></a></p>
  14031. <blockquote>
  14032. <p>Code samples</p>
  14033. </blockquote>
  14034. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  14035. curl -X DELETE /api/boards/{board}/lists/{list} \
  14036. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  14037. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  14038. </code></pre>
  14039. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">DELETE</span> <span class="hljs-string">/api/boards/{board}/lists/{list}</span> <span class="hljs-meta">HTTP/1.1</span>
  14040. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  14041. </span></code></pre>
  14042. <pre class="highlight tab tab-javascript"><code>
  14043. <span class="hljs-keyword">const</span> headers = {
  14044. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  14045. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  14046. };
  14047. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}&#x27;</span>,
  14048. {
  14049. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  14050. <span class="hljs-attr">headers</span>: headers
  14051. })
  14052. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  14053. <span class="hljs-keyword">return</span> res.json();
  14054. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  14055. <span class="hljs-built_in">console</span>.log(body);
  14056. });
  14057. </code></pre>
  14058. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  14059. <span class="hljs-keyword">const</span> headers = {
  14060. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  14061. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  14062. };
  14063. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}&#x27;</span>,
  14064. {
  14065. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  14066. <span class="hljs-attr">headers</span>: headers
  14067. })
  14068. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  14069. <span class="hljs-keyword">return</span> res.json();
  14070. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  14071. <span class="hljs-built_in">console</span>.log(body);
  14072. });
  14073. </code></pre>
  14074. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  14075. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  14076. headers = {
  14077. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  14078. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  14079. }
  14080. result = RestClient.delete <span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}&#x27;</span>,
  14081. <span class="hljs-symbol">params:</span> {
  14082. }, <span class="hljs-symbol">headers:</span> headers
  14083. p JSON.parse(result)
  14084. </code></pre>
  14085. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  14086. headers = {
  14087. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  14088. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  14089. }
  14090. r = requests.delete(<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}&#x27;</span>, headers = headers)
  14091. <span class="hljs-built_in">print</span>(r.json())
  14092. </code></pre>
  14093. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/lists/{list}&quot;</span>);
  14094. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  14095. con.setRequestMethod(<span class="hljs-string">&quot;DELETE&quot;</span>);
  14096. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  14097. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  14098. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  14099. String inputLine;
  14100. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  14101. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  14102. response.append(inputLine);
  14103. }
  14104. in.close();
  14105. System.out.println(response.toString());
  14106. </code></pre>
  14107. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  14108. <span class="hljs-keyword">import</span> (
  14109. <span class="hljs-string">&quot;bytes&quot;</span>
  14110. <span class="hljs-string">&quot;net/http&quot;</span>
  14111. )
  14112. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  14113. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  14114. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  14115. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  14116. }
  14117. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  14118. req, err := http.NewRequest(<span class="hljs-string">&quot;DELETE&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/lists/{list}&quot;</span>, data)
  14119. req.Header = headers
  14120. client := &amp;http.Client{}
  14121. resp, err := client.Do(req)
  14122. <span class="hljs-comment">// ...</span>
  14123. }
  14124. </code></pre>
  14125. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  14126. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  14127. );
  14128. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  14129. <span class="hljs-comment">// Define array of request body.</span>
  14130. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  14131. <span class="hljs-keyword">try</span> {
  14132. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;DELETE&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/lists/{list}&#x27;</span>, <span class="hljs-keyword">array</span>(
  14133. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  14134. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  14135. )
  14136. );
  14137. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  14138. }
  14139. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  14140. <span class="hljs-comment">// handle exception or api errors.</span>
  14141. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  14142. }
  14143. <span class="hljs-comment">// ...</span>
  14144. </code></pre>
  14145. <p><code>DELETE /api/boards/{board}/lists/{list}</code></p>
  14146. <p><em>Delete a List</em></p>
  14147. <p>This <strong>deletes</strong> a list from a board.
  14148. The list is not put in the recycle bin.</p>
  14149. <h3 id="delete_list-parameters">Parameters</h3>
  14150. <table>
  14151. <thead>
  14152. <tr>
  14153. <th>Name</th>
  14154. <th>In</th>
  14155. <th>Type</th>
  14156. <th>Required</th>
  14157. <th>Description</th>
  14158. </tr>
  14159. </thead>
  14160. <tbody>
  14161. <tr>
  14162. <td>board</td>
  14163. <td>path</td>
  14164. <td>string</td>
  14165. <td>true</td>
  14166. <td>the board ID</td>
  14167. </tr>
  14168. <tr>
  14169. <td>list</td>
  14170. <td>path</td>
  14171. <td>string</td>
  14172. <td>true</td>
  14173. <td>the ID of the list to remove</td>
  14174. </tr>
  14175. </tbody>
  14176. </table>
  14177. <h4 id="detailed-descriptions-43">Detailed descriptions</h4>
  14178. <p><strong>board</strong>: the board ID</p>
  14179. <p><strong>list</strong>: the ID of the list to remove</p>
  14180. <blockquote>
  14181. <p>Example responses</p>
  14182. </blockquote>
  14183. <blockquote>
  14184. <p>200 Response</p>
  14185. </blockquote>
  14186. <pre class="highlight tab tab-json"><code>{
  14187. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  14188. }
  14189. </code></pre>
  14190. <h3 id="delete_list-responses">Responses</h3>
  14191. <table>
  14192. <thead>
  14193. <tr>
  14194. <th>Status</th>
  14195. <th>Meaning</th>
  14196. <th>Description</th>
  14197. <th>Schema</th>
  14198. </tr>
  14199. </thead>
  14200. <tbody>
  14201. <tr>
  14202. <td>200</td>
  14203. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  14204. <td>200 response</td>
  14205. <td>Inline</td>
  14206. </tr>
  14207. </tbody>
  14208. </table>
  14209. <h3 id="delete_list-responseschema">Response Schema</h3>
  14210. <p>Status Code <strong>200</strong></p>
  14211. <table>
  14212. <thead>
  14213. <tr>
  14214. <th>Name</th>
  14215. <th>Type</th>
  14216. <th>Required</th>
  14217. <th>Restrictions</th>
  14218. <th>Description</th>
  14219. </tr>
  14220. </thead>
  14221. <tbody>
  14222. <tr>
  14223. <td>» _id</td>
  14224. <td>string</td>
  14225. <td>false</td>
  14226. <td>none</td>
  14227. <td>none</td>
  14228. </tr>
  14229. </tbody>
  14230. </table>
  14231. <aside class="warning">
  14232. To perform this operation, you must be authenticated by means of one of the following methods:
  14233. UserSecurity
  14234. </aside>
  14235. <h1 id="wekan-rest-api-users">Users</h1>
  14236. <h2 id="add_board_member">add_board_member</h2>
  14237. <p><a id="opIdadd_board_member"></a></p>
  14238. <blockquote>
  14239. <p>Code samples</p>
  14240. </blockquote>
  14241. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  14242. curl -X POST /api/boards/{board}/members/{user}/add \
  14243. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  14244. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  14245. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  14246. </code></pre>
  14247. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/boards/{board}/members/{user}/add</span> <span class="hljs-meta">HTTP/1.1</span>
  14248. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  14249. Accept: application/json
  14250. </span></code></pre>
  14251. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  14252. &quot;action&quot;: &quot;string&quot;,
  14253. &quot;isAdmin&quot;: true,
  14254. &quot;isNoComments&quot;: true,
  14255. &quot;isCommentOnly&quot;: true,
  14256. &quot;isWorker&quot;: true
  14257. }&#x27;</span>;
  14258. <span class="hljs-keyword">const</span> headers = {
  14259. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  14260. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  14261. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  14262. };
  14263. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/members/{user}/add&#x27;</span>,
  14264. {
  14265. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  14266. <span class="hljs-attr">body</span>: inputBody,
  14267. <span class="hljs-attr">headers</span>: headers
  14268. })
  14269. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  14270. <span class="hljs-keyword">return</span> res.json();
  14271. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  14272. <span class="hljs-built_in">console</span>.log(body);
  14273. });
  14274. </code></pre>
  14275. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  14276. <span class="hljs-keyword">const</span> inputBody = {
  14277. <span class="hljs-string">&quot;action&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  14278. <span class="hljs-string">&quot;isAdmin&quot;</span>: <span class="hljs-literal">true</span>,
  14279. <span class="hljs-string">&quot;isNoComments&quot;</span>: <span class="hljs-literal">true</span>,
  14280. <span class="hljs-string">&quot;isCommentOnly&quot;</span>: <span class="hljs-literal">true</span>,
  14281. <span class="hljs-string">&quot;isWorker&quot;</span>: <span class="hljs-literal">true</span>
  14282. };
  14283. <span class="hljs-keyword">const</span> headers = {
  14284. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  14285. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  14286. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  14287. };
  14288. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/members/{user}/add&#x27;</span>,
  14289. {
  14290. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  14291. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  14292. <span class="hljs-attr">headers</span>: headers
  14293. })
  14294. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  14295. <span class="hljs-keyword">return</span> res.json();
  14296. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  14297. <span class="hljs-built_in">console</span>.log(body);
  14298. });
  14299. </code></pre>
  14300. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  14301. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  14302. headers = {
  14303. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  14304. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  14305. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  14306. }
  14307. result = RestClient.post <span class="hljs-string">&#x27;/api/boards/{board}/members/{user}/add&#x27;</span>,
  14308. <span class="hljs-symbol">params:</span> {
  14309. }, <span class="hljs-symbol">headers:</span> headers
  14310. p JSON.parse(result)
  14311. </code></pre>
  14312. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  14313. headers = {
  14314. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  14315. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  14316. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  14317. }
  14318. r = requests.post(<span class="hljs-string">&#x27;/api/boards/{board}/members/{user}/add&#x27;</span>, headers = headers)
  14319. <span class="hljs-built_in">print</span>(r.json())
  14320. </code></pre>
  14321. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/members/{user}/add&quot;</span>);
  14322. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  14323. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  14324. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  14325. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  14326. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  14327. String inputLine;
  14328. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  14329. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  14330. response.append(inputLine);
  14331. }
  14332. in.close();
  14333. System.out.println(response.toString());
  14334. </code></pre>
  14335. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  14336. <span class="hljs-keyword">import</span> (
  14337. <span class="hljs-string">&quot;bytes&quot;</span>
  14338. <span class="hljs-string">&quot;net/http&quot;</span>
  14339. )
  14340. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  14341. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  14342. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  14343. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  14344. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  14345. }
  14346. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  14347. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/members/{user}/add&quot;</span>, data)
  14348. req.Header = headers
  14349. client := &amp;http.Client{}
  14350. resp, err := client.Do(req)
  14351. <span class="hljs-comment">// ...</span>
  14352. }
  14353. </code></pre>
  14354. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  14355. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  14356. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  14357. );
  14358. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  14359. <span class="hljs-comment">// Define array of request body.</span>
  14360. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  14361. <span class="hljs-keyword">try</span> {
  14362. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/members/{user}/add&#x27;</span>, <span class="hljs-keyword">array</span>(
  14363. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  14364. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  14365. )
  14366. );
  14367. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  14368. }
  14369. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  14370. <span class="hljs-comment">// handle exception or api errors.</span>
  14371. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  14372. }
  14373. <span class="hljs-comment">// ...</span>
  14374. </code></pre>
  14375. <p><code>POST /api/boards/{board}/members/{user}/add</code></p>
  14376. <p><em>Add New Board Member with Role</em></p>
  14377. <p>Only the admin user (the first user) can call the REST API.</p>
  14378. <p><strong>Note</strong>: see <a href="#set_board_member_permission">Boards.set_board_member_permission</a>
  14379. to later change the permissions.</p>
  14380. <blockquote>
  14381. <p>Body parameter</p>
  14382. </blockquote>
  14383. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">action:</span> <span class="hljs-string">string</span>
  14384. <span class="hljs-attr">isAdmin:</span> <span class="hljs-literal">true</span>
  14385. <span class="hljs-attr">isNoComments:</span> <span class="hljs-literal">true</span>
  14386. <span class="hljs-attr">isCommentOnly:</span> <span class="hljs-literal">true</span>
  14387. <span class="hljs-attr">isWorker:</span> <span class="hljs-literal">true</span>
  14388. </code></pre>
  14389. <h3 id="add_board_member-parameters">Parameters</h3>
  14390. <table>
  14391. <thead>
  14392. <tr>
  14393. <th>Name</th>
  14394. <th>In</th>
  14395. <th>Type</th>
  14396. <th>Required</th>
  14397. <th>Description</th>
  14398. </tr>
  14399. </thead>
  14400. <tbody>
  14401. <tr>
  14402. <td>board</td>
  14403. <td>path</td>
  14404. <td>string</td>
  14405. <td>true</td>
  14406. <td>the board ID</td>
  14407. </tr>
  14408. <tr>
  14409. <td>user</td>
  14410. <td>path</td>
  14411. <td>string</td>
  14412. <td>true</td>
  14413. <td>the user ID</td>
  14414. </tr>
  14415. <tr>
  14416. <td>body</td>
  14417. <td>body</td>
  14418. <td>object</td>
  14419. <td>true</td>
  14420. <td>none</td>
  14421. </tr>
  14422. <tr>
  14423. <td>» action</td>
  14424. <td>body</td>
  14425. <td>string</td>
  14426. <td>true</td>
  14427. <td>the action (needs to be <code>add</code>)</td>
  14428. </tr>
  14429. <tr>
  14430. <td>» isAdmin</td>
  14431. <td>body</td>
  14432. <td>boolean</td>
  14433. <td>true</td>
  14434. <td>is the user an admin of the board</td>
  14435. </tr>
  14436. <tr>
  14437. <td>» isNoComments</td>
  14438. <td>body</td>
  14439. <td>boolean</td>
  14440. <td>true</td>
  14441. <td>disable comments</td>
  14442. </tr>
  14443. <tr>
  14444. <td>» isCommentOnly</td>
  14445. <td>body</td>
  14446. <td>boolean</td>
  14447. <td>true</td>
  14448. <td>only enable comments</td>
  14449. </tr>
  14450. <tr>
  14451. <td>» isWorker</td>
  14452. <td>body</td>
  14453. <td>boolean</td>
  14454. <td>true</td>
  14455. <td>is the user a board worker</td>
  14456. </tr>
  14457. </tbody>
  14458. </table>
  14459. <h4 id="detailed-descriptions-44">Detailed descriptions</h4>
  14460. <p><strong>board</strong>: the board ID</p>
  14461. <p><strong>user</strong>: the user ID</p>
  14462. <blockquote>
  14463. <p>Example responses</p>
  14464. </blockquote>
  14465. <blockquote>
  14466. <p>200 Response</p>
  14467. </blockquote>
  14468. <pre class="highlight tab tab-json"><code>{
  14469. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  14470. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  14471. }
  14472. </code></pre>
  14473. <h3 id="add_board_member-responses">Responses</h3>
  14474. <table>
  14475. <thead>
  14476. <tr>
  14477. <th>Status</th>
  14478. <th>Meaning</th>
  14479. <th>Description</th>
  14480. <th>Schema</th>
  14481. </tr>
  14482. </thead>
  14483. <tbody>
  14484. <tr>
  14485. <td>200</td>
  14486. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  14487. <td>200 response</td>
  14488. <td>Inline</td>
  14489. </tr>
  14490. </tbody>
  14491. </table>
  14492. <h3 id="add_board_member-responseschema">Response Schema</h3>
  14493. <p>Status Code <strong>200</strong></p>
  14494. <table>
  14495. <thead>
  14496. <tr>
  14497. <th>Name</th>
  14498. <th>Type</th>
  14499. <th>Required</th>
  14500. <th>Restrictions</th>
  14501. <th>Description</th>
  14502. </tr>
  14503. </thead>
  14504. <tbody>
  14505. <tr>
  14506. <td>» _id</td>
  14507. <td>string</td>
  14508. <td>false</td>
  14509. <td>none</td>
  14510. <td>none</td>
  14511. </tr>
  14512. <tr>
  14513. <td>» title</td>
  14514. <td>string</td>
  14515. <td>false</td>
  14516. <td>none</td>
  14517. <td>none</td>
  14518. </tr>
  14519. </tbody>
  14520. </table>
  14521. <aside class="warning">
  14522. To perform this operation, you must be authenticated by means of one of the following methods:
  14523. UserSecurity
  14524. </aside>
  14525. <h2 id="remove_board_member">remove_board_member</h2>
  14526. <p><a id="opIdremove_board_member"></a></p>
  14527. <blockquote>
  14528. <p>Code samples</p>
  14529. </blockquote>
  14530. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  14531. curl -X POST /api/boards/{board}/members/{user}/remove \
  14532. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  14533. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  14534. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  14535. </code></pre>
  14536. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/boards/{board}/members/{user}/remove</span> <span class="hljs-meta">HTTP/1.1</span>
  14537. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  14538. Accept: application/json
  14539. </span></code></pre>
  14540. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  14541. &quot;action&quot;: &quot;string&quot;
  14542. }&#x27;</span>;
  14543. <span class="hljs-keyword">const</span> headers = {
  14544. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  14545. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  14546. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  14547. };
  14548. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/members/{user}/remove&#x27;</span>,
  14549. {
  14550. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  14551. <span class="hljs-attr">body</span>: inputBody,
  14552. <span class="hljs-attr">headers</span>: headers
  14553. })
  14554. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  14555. <span class="hljs-keyword">return</span> res.json();
  14556. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  14557. <span class="hljs-built_in">console</span>.log(body);
  14558. });
  14559. </code></pre>
  14560. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  14561. <span class="hljs-keyword">const</span> inputBody = {
  14562. <span class="hljs-string">&quot;action&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  14563. };
  14564. <span class="hljs-keyword">const</span> headers = {
  14565. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  14566. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  14567. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  14568. };
  14569. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/members/{user}/remove&#x27;</span>,
  14570. {
  14571. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  14572. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  14573. <span class="hljs-attr">headers</span>: headers
  14574. })
  14575. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  14576. <span class="hljs-keyword">return</span> res.json();
  14577. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  14578. <span class="hljs-built_in">console</span>.log(body);
  14579. });
  14580. </code></pre>
  14581. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  14582. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  14583. headers = {
  14584. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  14585. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  14586. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  14587. }
  14588. result = RestClient.post <span class="hljs-string">&#x27;/api/boards/{board}/members/{user}/remove&#x27;</span>,
  14589. <span class="hljs-symbol">params:</span> {
  14590. }, <span class="hljs-symbol">headers:</span> headers
  14591. p JSON.parse(result)
  14592. </code></pre>
  14593. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  14594. headers = {
  14595. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  14596. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  14597. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  14598. }
  14599. r = requests.post(<span class="hljs-string">&#x27;/api/boards/{board}/members/{user}/remove&#x27;</span>, headers = headers)
  14600. <span class="hljs-built_in">print</span>(r.json())
  14601. </code></pre>
  14602. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/members/{user}/remove&quot;</span>);
  14603. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  14604. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  14605. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  14606. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  14607. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  14608. String inputLine;
  14609. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  14610. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  14611. response.append(inputLine);
  14612. }
  14613. in.close();
  14614. System.out.println(response.toString());
  14615. </code></pre>
  14616. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  14617. <span class="hljs-keyword">import</span> (
  14618. <span class="hljs-string">&quot;bytes&quot;</span>
  14619. <span class="hljs-string">&quot;net/http&quot;</span>
  14620. )
  14621. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  14622. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  14623. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  14624. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  14625. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  14626. }
  14627. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  14628. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/members/{user}/remove&quot;</span>, data)
  14629. req.Header = headers
  14630. client := &amp;http.Client{}
  14631. resp, err := client.Do(req)
  14632. <span class="hljs-comment">// ...</span>
  14633. }
  14634. </code></pre>
  14635. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  14636. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  14637. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  14638. );
  14639. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  14640. <span class="hljs-comment">// Define array of request body.</span>
  14641. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  14642. <span class="hljs-keyword">try</span> {
  14643. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/members/{user}/remove&#x27;</span>, <span class="hljs-keyword">array</span>(
  14644. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  14645. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  14646. )
  14647. );
  14648. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  14649. }
  14650. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  14651. <span class="hljs-comment">// handle exception or api errors.</span>
  14652. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  14653. }
  14654. <span class="hljs-comment">// ...</span>
  14655. </code></pre>
  14656. <p><code>POST /api/boards/{board}/members/{user}/remove</code></p>
  14657. <p><em>Remove Member from Board</em></p>
  14658. <p>Only the admin user (the first user) can call the REST API.</p>
  14659. <blockquote>
  14660. <p>Body parameter</p>
  14661. </blockquote>
  14662. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">action:</span> <span class="hljs-string">string</span>
  14663. </code></pre>
  14664. <h3 id="remove_board_member-parameters">Parameters</h3>
  14665. <table>
  14666. <thead>
  14667. <tr>
  14668. <th>Name</th>
  14669. <th>In</th>
  14670. <th>Type</th>
  14671. <th>Required</th>
  14672. <th>Description</th>
  14673. </tr>
  14674. </thead>
  14675. <tbody>
  14676. <tr>
  14677. <td>board</td>
  14678. <td>path</td>
  14679. <td>string</td>
  14680. <td>true</td>
  14681. <td>the board ID</td>
  14682. </tr>
  14683. <tr>
  14684. <td>user</td>
  14685. <td>path</td>
  14686. <td>string</td>
  14687. <td>true</td>
  14688. <td>the user ID</td>
  14689. </tr>
  14690. <tr>
  14691. <td>body</td>
  14692. <td>body</td>
  14693. <td>object</td>
  14694. <td>true</td>
  14695. <td>none</td>
  14696. </tr>
  14697. <tr>
  14698. <td>» action</td>
  14699. <td>body</td>
  14700. <td>string</td>
  14701. <td>true</td>
  14702. <td>the action (needs to be <code>remove</code>)</td>
  14703. </tr>
  14704. </tbody>
  14705. </table>
  14706. <h4 id="detailed-descriptions-45">Detailed descriptions</h4>
  14707. <p><strong>board</strong>: the board ID</p>
  14708. <p><strong>user</strong>: the user ID</p>
  14709. <blockquote>
  14710. <p>Example responses</p>
  14711. </blockquote>
  14712. <blockquote>
  14713. <p>200 Response</p>
  14714. </blockquote>
  14715. <pre class="highlight tab tab-json"><code>{
  14716. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  14717. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  14718. }
  14719. </code></pre>
  14720. <h3 id="remove_board_member-responses">Responses</h3>
  14721. <table>
  14722. <thead>
  14723. <tr>
  14724. <th>Status</th>
  14725. <th>Meaning</th>
  14726. <th>Description</th>
  14727. <th>Schema</th>
  14728. </tr>
  14729. </thead>
  14730. <tbody>
  14731. <tr>
  14732. <td>200</td>
  14733. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  14734. <td>200 response</td>
  14735. <td>Inline</td>
  14736. </tr>
  14737. </tbody>
  14738. </table>
  14739. <h3 id="remove_board_member-responseschema">Response Schema</h3>
  14740. <p>Status Code <strong>200</strong></p>
  14741. <table>
  14742. <thead>
  14743. <tr>
  14744. <th>Name</th>
  14745. <th>Type</th>
  14746. <th>Required</th>
  14747. <th>Restrictions</th>
  14748. <th>Description</th>
  14749. </tr>
  14750. </thead>
  14751. <tbody>
  14752. <tr>
  14753. <td>» _id</td>
  14754. <td>string</td>
  14755. <td>false</td>
  14756. <td>none</td>
  14757. <td>none</td>
  14758. </tr>
  14759. <tr>
  14760. <td>» title</td>
  14761. <td>string</td>
  14762. <td>false</td>
  14763. <td>none</td>
  14764. <td>none</td>
  14765. </tr>
  14766. </tbody>
  14767. </table>
  14768. <aside class="warning">
  14769. To perform this operation, you must be authenticated by means of one of the following methods:
  14770. UserSecurity
  14771. </aside>
  14772. <h2 id="create_user_token">create_user_token</h2>
  14773. <p><a id="opIdcreate_user_token"></a></p>
  14774. <blockquote>
  14775. <p>Code samples</p>
  14776. </blockquote>
  14777. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  14778. curl -X POST /api/createtoken/{user} \
  14779. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  14780. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  14781. </code></pre>
  14782. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/createtoken/{user}</span> <span class="hljs-meta">HTTP/1.1</span>
  14783. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  14784. </span></code></pre>
  14785. <pre class="highlight tab tab-javascript"><code>
  14786. <span class="hljs-keyword">const</span> headers = {
  14787. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  14788. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  14789. };
  14790. fetch(<span class="hljs-string">&#x27;/api/createtoken/{user}&#x27;</span>,
  14791. {
  14792. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  14793. <span class="hljs-attr">headers</span>: headers
  14794. })
  14795. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  14796. <span class="hljs-keyword">return</span> res.json();
  14797. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  14798. <span class="hljs-built_in">console</span>.log(body);
  14799. });
  14800. </code></pre>
  14801. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  14802. <span class="hljs-keyword">const</span> headers = {
  14803. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  14804. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  14805. };
  14806. fetch(<span class="hljs-string">&#x27;/api/createtoken/{user}&#x27;</span>,
  14807. {
  14808. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  14809. <span class="hljs-attr">headers</span>: headers
  14810. })
  14811. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  14812. <span class="hljs-keyword">return</span> res.json();
  14813. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  14814. <span class="hljs-built_in">console</span>.log(body);
  14815. });
  14816. </code></pre>
  14817. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  14818. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  14819. headers = {
  14820. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  14821. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  14822. }
  14823. result = RestClient.post <span class="hljs-string">&#x27;/api/createtoken/{user}&#x27;</span>,
  14824. <span class="hljs-symbol">params:</span> {
  14825. }, <span class="hljs-symbol">headers:</span> headers
  14826. p JSON.parse(result)
  14827. </code></pre>
  14828. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  14829. headers = {
  14830. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  14831. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  14832. }
  14833. r = requests.post(<span class="hljs-string">&#x27;/api/createtoken/{user}&#x27;</span>, headers = headers)
  14834. <span class="hljs-built_in">print</span>(r.json())
  14835. </code></pre>
  14836. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/createtoken/{user}&quot;</span>);
  14837. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  14838. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  14839. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  14840. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  14841. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  14842. String inputLine;
  14843. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  14844. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  14845. response.append(inputLine);
  14846. }
  14847. in.close();
  14848. System.out.println(response.toString());
  14849. </code></pre>
  14850. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  14851. <span class="hljs-keyword">import</span> (
  14852. <span class="hljs-string">&quot;bytes&quot;</span>
  14853. <span class="hljs-string">&quot;net/http&quot;</span>
  14854. )
  14855. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  14856. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  14857. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  14858. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  14859. }
  14860. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  14861. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/createtoken/{user}&quot;</span>, data)
  14862. req.Header = headers
  14863. client := &amp;http.Client{}
  14864. resp, err := client.Do(req)
  14865. <span class="hljs-comment">// ...</span>
  14866. }
  14867. </code></pre>
  14868. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  14869. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  14870. );
  14871. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  14872. <span class="hljs-comment">// Define array of request body.</span>
  14873. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  14874. <span class="hljs-keyword">try</span> {
  14875. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/createtoken/{user}&#x27;</span>, <span class="hljs-keyword">array</span>(
  14876. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  14877. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  14878. )
  14879. );
  14880. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  14881. }
  14882. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  14883. <span class="hljs-comment">// handle exception or api errors.</span>
  14884. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  14885. }
  14886. <span class="hljs-comment">// ...</span>
  14887. </code></pre>
  14888. <p><code>POST /api/createtoken/{user}</code></p>
  14889. <p><em>Create a user token</em></p>
  14890. <p>Only the admin user (the first user) can call the REST API.</p>
  14891. <h3 id="create_user_token-parameters">Parameters</h3>
  14892. <table>
  14893. <thead>
  14894. <tr>
  14895. <th>Name</th>
  14896. <th>In</th>
  14897. <th>Type</th>
  14898. <th>Required</th>
  14899. <th>Description</th>
  14900. </tr>
  14901. </thead>
  14902. <tbody>
  14903. <tr>
  14904. <td>user</td>
  14905. <td>path</td>
  14906. <td>string</td>
  14907. <td>true</td>
  14908. <td>the ID of the user to create token for.</td>
  14909. </tr>
  14910. </tbody>
  14911. </table>
  14912. <h4 id="detailed-descriptions-46">Detailed descriptions</h4>
  14913. <p><strong>user</strong>: the ID of the user to create token for.</p>
  14914. <blockquote>
  14915. <p>Example responses</p>
  14916. </blockquote>
  14917. <blockquote>
  14918. <p>200 Response</p>
  14919. </blockquote>
  14920. <pre class="highlight tab tab-json"><code>{
  14921. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  14922. }
  14923. </code></pre>
  14924. <h3 id="create_user_token-responses">Responses</h3>
  14925. <table>
  14926. <thead>
  14927. <tr>
  14928. <th>Status</th>
  14929. <th>Meaning</th>
  14930. <th>Description</th>
  14931. <th>Schema</th>
  14932. </tr>
  14933. </thead>
  14934. <tbody>
  14935. <tr>
  14936. <td>200</td>
  14937. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  14938. <td>200 response</td>
  14939. <td>Inline</td>
  14940. </tr>
  14941. </tbody>
  14942. </table>
  14943. <h3 id="create_user_token-responseschema">Response Schema</h3>
  14944. <p>Status Code <strong>200</strong></p>
  14945. <table>
  14946. <thead>
  14947. <tr>
  14948. <th>Name</th>
  14949. <th>Type</th>
  14950. <th>Required</th>
  14951. <th>Restrictions</th>
  14952. <th>Description</th>
  14953. </tr>
  14954. </thead>
  14955. <tbody>
  14956. <tr>
  14957. <td>» _id</td>
  14958. <td>string</td>
  14959. <td>false</td>
  14960. <td>none</td>
  14961. <td>none</td>
  14962. </tr>
  14963. </tbody>
  14964. </table>
  14965. <aside class="warning">
  14966. To perform this operation, you must be authenticated by means of one of the following methods:
  14967. UserSecurity
  14968. </aside>
  14969. <h2 id="delete_user_token">delete_user_token</h2>
  14970. <p><a id="opIddelete_user_token"></a></p>
  14971. <blockquote>
  14972. <p>Code samples</p>
  14973. </blockquote>
  14974. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  14975. curl -X POST /api/deletetoken \
  14976. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  14977. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  14978. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  14979. </code></pre>
  14980. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/deletetoken</span> <span class="hljs-meta">HTTP/1.1</span>
  14981. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  14982. Accept: application/json
  14983. </span></code></pre>
  14984. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  14985. &quot;userId&quot;: &quot;string&quot;,
  14986. &quot;token&quot;: &quot;string&quot;
  14987. }&#x27;</span>;
  14988. <span class="hljs-keyword">const</span> headers = {
  14989. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  14990. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  14991. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  14992. };
  14993. fetch(<span class="hljs-string">&#x27;/api/deletetoken&#x27;</span>,
  14994. {
  14995. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  14996. <span class="hljs-attr">body</span>: inputBody,
  14997. <span class="hljs-attr">headers</span>: headers
  14998. })
  14999. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  15000. <span class="hljs-keyword">return</span> res.json();
  15001. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  15002. <span class="hljs-built_in">console</span>.log(body);
  15003. });
  15004. </code></pre>
  15005. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  15006. <span class="hljs-keyword">const</span> inputBody = {
  15007. <span class="hljs-string">&quot;userId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15008. <span class="hljs-string">&quot;token&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  15009. };
  15010. <span class="hljs-keyword">const</span> headers = {
  15011. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  15012. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  15013. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15014. };
  15015. fetch(<span class="hljs-string">&#x27;/api/deletetoken&#x27;</span>,
  15016. {
  15017. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  15018. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  15019. <span class="hljs-attr">headers</span>: headers
  15020. })
  15021. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  15022. <span class="hljs-keyword">return</span> res.json();
  15023. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  15024. <span class="hljs-built_in">console</span>.log(body);
  15025. });
  15026. </code></pre>
  15027. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  15028. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  15029. headers = {
  15030. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  15031. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  15032. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15033. }
  15034. result = RestClient.post <span class="hljs-string">&#x27;/api/deletetoken&#x27;</span>,
  15035. <span class="hljs-symbol">params:</span> {
  15036. }, <span class="hljs-symbol">headers:</span> headers
  15037. p JSON.parse(result)
  15038. </code></pre>
  15039. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  15040. headers = {
  15041. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  15042. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  15043. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15044. }
  15045. r = requests.post(<span class="hljs-string">&#x27;/api/deletetoken&#x27;</span>, headers = headers)
  15046. <span class="hljs-built_in">print</span>(r.json())
  15047. </code></pre>
  15048. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/deletetoken&quot;</span>);
  15049. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  15050. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  15051. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  15052. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  15053. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  15054. String inputLine;
  15055. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  15056. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  15057. response.append(inputLine);
  15058. }
  15059. in.close();
  15060. System.out.println(response.toString());
  15061. </code></pre>
  15062. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  15063. <span class="hljs-keyword">import</span> (
  15064. <span class="hljs-string">&quot;bytes&quot;</span>
  15065. <span class="hljs-string">&quot;net/http&quot;</span>
  15066. )
  15067. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  15068. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  15069. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  15070. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  15071. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  15072. }
  15073. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  15074. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/deletetoken&quot;</span>, data)
  15075. req.Header = headers
  15076. client := &amp;http.Client{}
  15077. resp, err := client.Do(req)
  15078. <span class="hljs-comment">// ...</span>
  15079. }
  15080. </code></pre>
  15081. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  15082. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  15083. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  15084. );
  15085. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  15086. <span class="hljs-comment">// Define array of request body.</span>
  15087. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  15088. <span class="hljs-keyword">try</span> {
  15089. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/deletetoken&#x27;</span>, <span class="hljs-keyword">array</span>(
  15090. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  15091. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  15092. )
  15093. );
  15094. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  15095. }
  15096. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  15097. <span class="hljs-comment">// handle exception or api errors.</span>
  15098. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  15099. }
  15100. <span class="hljs-comment">// ...</span>
  15101. </code></pre>
  15102. <p><code>POST /api/deletetoken</code></p>
  15103. <p><em>Delete one or all user token.</em></p>
  15104. <p>Only the admin user (the first user) can call the REST API.</p>
  15105. <blockquote>
  15106. <p>Body parameter</p>
  15107. </blockquote>
  15108. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">userId:</span> <span class="hljs-string">string</span>
  15109. <span class="hljs-attr">token:</span> <span class="hljs-string">string</span>
  15110. </code></pre>
  15111. <h3 id="delete_user_token-parameters">Parameters</h3>
  15112. <table>
  15113. <thead>
  15114. <tr>
  15115. <th>Name</th>
  15116. <th>In</th>
  15117. <th>Type</th>
  15118. <th>Required</th>
  15119. <th>Description</th>
  15120. </tr>
  15121. </thead>
  15122. <tbody>
  15123. <tr>
  15124. <td>body</td>
  15125. <td>body</td>
  15126. <td>object</td>
  15127. <td>true</td>
  15128. <td>none</td>
  15129. </tr>
  15130. <tr>
  15131. <td>» userId</td>
  15132. <td>body</td>
  15133. <td>string</td>
  15134. <td>true</td>
  15135. <td>the user ID</td>
  15136. </tr>
  15137. <tr>
  15138. <td>» token</td>
  15139. <td>body</td>
  15140. <td>string</td>
  15141. <td>true</td>
  15142. <td>the user hashedToken</td>
  15143. </tr>
  15144. </tbody>
  15145. </table>
  15146. <blockquote>
  15147. <p>Example responses</p>
  15148. </blockquote>
  15149. <blockquote>
  15150. <p>200 Response</p>
  15151. </blockquote>
  15152. <pre class="highlight tab tab-json"><code>{
  15153. <span class="hljs-attr">&quot;message&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  15154. }
  15155. </code></pre>
  15156. <h3 id="delete_user_token-responses">Responses</h3>
  15157. <table>
  15158. <thead>
  15159. <tr>
  15160. <th>Status</th>
  15161. <th>Meaning</th>
  15162. <th>Description</th>
  15163. <th>Schema</th>
  15164. </tr>
  15165. </thead>
  15166. <tbody>
  15167. <tr>
  15168. <td>200</td>
  15169. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  15170. <td>200 response</td>
  15171. <td>Inline</td>
  15172. </tr>
  15173. </tbody>
  15174. </table>
  15175. <h3 id="delete_user_token-responseschema">Response Schema</h3>
  15176. <p>Status Code <strong>200</strong></p>
  15177. <table>
  15178. <thead>
  15179. <tr>
  15180. <th>Name</th>
  15181. <th>Type</th>
  15182. <th>Required</th>
  15183. <th>Restrictions</th>
  15184. <th>Description</th>
  15185. </tr>
  15186. </thead>
  15187. <tbody>
  15188. <tr>
  15189. <td>» message</td>
  15190. <td>string</td>
  15191. <td>false</td>
  15192. <td>none</td>
  15193. <td>none</td>
  15194. </tr>
  15195. </tbody>
  15196. </table>
  15197. <aside class="warning">
  15198. To perform this operation, you must be authenticated by means of one of the following methods:
  15199. UserSecurity
  15200. </aside>
  15201. <h2 id="get_current_user">get_current_user</h2>
  15202. <p><a id="opIdget_current_user"></a></p>
  15203. <blockquote>
  15204. <p>Code samples</p>
  15205. </blockquote>
  15206. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  15207. curl -X GET /api/user \
  15208. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  15209. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  15210. </code></pre>
  15211. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/user</span> <span class="hljs-meta">HTTP/1.1</span>
  15212. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  15213. </span></code></pre>
  15214. <pre class="highlight tab tab-javascript"><code>
  15215. <span class="hljs-keyword">const</span> headers = {
  15216. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  15217. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15218. };
  15219. fetch(<span class="hljs-string">&#x27;/api/user&#x27;</span>,
  15220. {
  15221. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  15222. <span class="hljs-attr">headers</span>: headers
  15223. })
  15224. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  15225. <span class="hljs-keyword">return</span> res.json();
  15226. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  15227. <span class="hljs-built_in">console</span>.log(body);
  15228. });
  15229. </code></pre>
  15230. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  15231. <span class="hljs-keyword">const</span> headers = {
  15232. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  15233. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15234. };
  15235. fetch(<span class="hljs-string">&#x27;/api/user&#x27;</span>,
  15236. {
  15237. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  15238. <span class="hljs-attr">headers</span>: headers
  15239. })
  15240. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  15241. <span class="hljs-keyword">return</span> res.json();
  15242. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  15243. <span class="hljs-built_in">console</span>.log(body);
  15244. });
  15245. </code></pre>
  15246. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  15247. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  15248. headers = {
  15249. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  15250. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15251. }
  15252. result = RestClient.get <span class="hljs-string">&#x27;/api/user&#x27;</span>,
  15253. <span class="hljs-symbol">params:</span> {
  15254. }, <span class="hljs-symbol">headers:</span> headers
  15255. p JSON.parse(result)
  15256. </code></pre>
  15257. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  15258. headers = {
  15259. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  15260. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15261. }
  15262. r = requests.get(<span class="hljs-string">&#x27;/api/user&#x27;</span>, headers = headers)
  15263. <span class="hljs-built_in">print</span>(r.json())
  15264. </code></pre>
  15265. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/user&quot;</span>);
  15266. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  15267. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  15268. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  15269. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  15270. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  15271. String inputLine;
  15272. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  15273. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  15274. response.append(inputLine);
  15275. }
  15276. in.close();
  15277. System.out.println(response.toString());
  15278. </code></pre>
  15279. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  15280. <span class="hljs-keyword">import</span> (
  15281. <span class="hljs-string">&quot;bytes&quot;</span>
  15282. <span class="hljs-string">&quot;net/http&quot;</span>
  15283. )
  15284. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  15285. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  15286. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  15287. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  15288. }
  15289. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  15290. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/user&quot;</span>, data)
  15291. req.Header = headers
  15292. client := &amp;http.Client{}
  15293. resp, err := client.Do(req)
  15294. <span class="hljs-comment">// ...</span>
  15295. }
  15296. </code></pre>
  15297. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  15298. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  15299. );
  15300. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  15301. <span class="hljs-comment">// Define array of request body.</span>
  15302. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  15303. <span class="hljs-keyword">try</span> {
  15304. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/user&#x27;</span>, <span class="hljs-keyword">array</span>(
  15305. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  15306. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  15307. )
  15308. );
  15309. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  15310. }
  15311. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  15312. <span class="hljs-comment">// handle exception or api errors.</span>
  15313. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  15314. }
  15315. <span class="hljs-comment">// ...</span>
  15316. </code></pre>
  15317. <p><code>GET /api/user</code></p>
  15318. <p><em>returns the current user</em></p>
  15319. <blockquote>
  15320. <p>Example responses</p>
  15321. </blockquote>
  15322. <blockquote>
  15323. <p>200 Response</p>
  15324. </blockquote>
  15325. <pre class="highlight tab tab-json"><code>{
  15326. <span class="hljs-attr">&quot;username&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15327. <span class="hljs-attr">&quot;orgs&quot;</span>: [
  15328. {
  15329. <span class="hljs-attr">&quot;orgId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15330. <span class="hljs-attr">&quot;orgDisplayName&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  15331. }
  15332. ],
  15333. <span class="hljs-attr">&quot;teams&quot;</span>: [
  15334. {
  15335. <span class="hljs-attr">&quot;teamId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15336. <span class="hljs-attr">&quot;teamDisplayName&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  15337. }
  15338. ],
  15339. <span class="hljs-attr">&quot;emails&quot;</span>: [
  15340. {
  15341. <span class="hljs-attr">&quot;address&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15342. <span class="hljs-attr">&quot;verified&quot;</span>: <span class="hljs-literal">true</span>
  15343. }
  15344. ],
  15345. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15346. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15347. <span class="hljs-attr">&quot;profile&quot;</span>: {
  15348. <span class="hljs-attr">&quot;avatarUrl&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15349. <span class="hljs-attr">&quot;emailBuffer&quot;</span>: [
  15350. <span class="hljs-string">&quot;string&quot;</span>
  15351. ],
  15352. <span class="hljs-attr">&quot;fullname&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15353. <span class="hljs-attr">&quot;showDesktopDragHandles&quot;</span>: <span class="hljs-literal">true</span>,
  15354. <span class="hljs-attr">&quot;hideCheckedItems&quot;</span>: <span class="hljs-literal">true</span>,
  15355. <span class="hljs-attr">&quot;cardMaximized&quot;</span>: <span class="hljs-literal">true</span>,
  15356. <span class="hljs-attr">&quot;customFieldsGrid&quot;</span>: <span class="hljs-literal">true</span>,
  15357. <span class="hljs-attr">&quot;hiddenSystemMessages&quot;</span>: <span class="hljs-literal">true</span>,
  15358. <span class="hljs-attr">&quot;hiddenMinicardLabelText&quot;</span>: <span class="hljs-literal">true</span>,
  15359. <span class="hljs-attr">&quot;initials&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15360. <span class="hljs-attr">&quot;invitedBoards&quot;</span>: [
  15361. <span class="hljs-string">&quot;string&quot;</span>
  15362. ],
  15363. <span class="hljs-attr">&quot;language&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15364. <span class="hljs-attr">&quot;moveAndCopyDialog&quot;</span>: {},
  15365. <span class="hljs-attr">&quot;moveChecklistDialog&quot;</span>: {},
  15366. <span class="hljs-attr">&quot;copyChecklistDialog&quot;</span>: {},
  15367. <span class="hljs-attr">&quot;notifications&quot;</span>: [
  15368. {
  15369. <span class="hljs-attr">&quot;activity&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15370. <span class="hljs-attr">&quot;read&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  15371. }
  15372. ],
  15373. <span class="hljs-attr">&quot;rescueCardDescription&quot;</span>: <span class="hljs-literal">true</span>,
  15374. <span class="hljs-attr">&quot;showCardsCountAt&quot;</span>: <span class="hljs-number">0</span>,
  15375. <span class="hljs-attr">&quot;startDayOfWeek&quot;</span>: <span class="hljs-number">0</span>,
  15376. <span class="hljs-attr">&quot;starredBoards&quot;</span>: [
  15377. <span class="hljs-string">&quot;string&quot;</span>
  15378. ],
  15379. <span class="hljs-attr">&quot;icode&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15380. <span class="hljs-attr">&quot;boardView&quot;</span>: <span class="hljs-string">&quot;board-view-swimlanes&quot;</span>,
  15381. <span class="hljs-attr">&quot;listSortBy&quot;</span>: <span class="hljs-string">&quot;-modifiedat&quot;</span>,
  15382. <span class="hljs-attr">&quot;templatesBoardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15383. <span class="hljs-attr">&quot;cardTemplatesSwimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15384. <span class="hljs-attr">&quot;listTemplatesSwimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15385. <span class="hljs-attr">&quot;boardTemplatesSwimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  15386. },
  15387. <span class="hljs-attr">&quot;services&quot;</span>: {},
  15388. <span class="hljs-attr">&quot;heartbeat&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15389. <span class="hljs-attr">&quot;isAdmin&quot;</span>: <span class="hljs-literal">true</span>,
  15390. <span class="hljs-attr">&quot;createdThroughApi&quot;</span>: <span class="hljs-literal">true</span>,
  15391. <span class="hljs-attr">&quot;loginDisabled&quot;</span>: <span class="hljs-literal">true</span>,
  15392. <span class="hljs-attr">&quot;authenticationMethod&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15393. <span class="hljs-attr">&quot;sessionData&quot;</span>: {
  15394. <span class="hljs-attr">&quot;totalHits&quot;</span>: <span class="hljs-number">0</span>
  15395. },
  15396. <span class="hljs-attr">&quot;importUsernames&quot;</span>: [
  15397. <span class="hljs-string">&quot;string&quot;</span>
  15398. ],
  15399. <span class="hljs-attr">&quot;lastConnectionDate&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  15400. }
  15401. </code></pre>
  15402. <h3 id="get_current_user-responses">Responses</h3>
  15403. <table>
  15404. <thead>
  15405. <tr>
  15406. <th>Status</th>
  15407. <th>Meaning</th>
  15408. <th>Description</th>
  15409. <th>Schema</th>
  15410. </tr>
  15411. </thead>
  15412. <tbody>
  15413. <tr>
  15414. <td>200</td>
  15415. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  15416. <td>200 response</td>
  15417. <td><a href="#schemausers">Users</a></td>
  15418. </tr>
  15419. </tbody>
  15420. </table>
  15421. <aside class="warning">
  15422. To perform this operation, you must be authenticated by means of one of the following methods:
  15423. UserSecurity
  15424. </aside>
  15425. <h2 id="get_all_users">get_all_users</h2>
  15426. <p><a id="opIdget_all_users"></a></p>
  15427. <blockquote>
  15428. <p>Code samples</p>
  15429. </blockquote>
  15430. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  15431. curl -X GET /api/users \
  15432. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  15433. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  15434. </code></pre>
  15435. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/users</span> <span class="hljs-meta">HTTP/1.1</span>
  15436. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  15437. </span></code></pre>
  15438. <pre class="highlight tab tab-javascript"><code>
  15439. <span class="hljs-keyword">const</span> headers = {
  15440. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  15441. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15442. };
  15443. fetch(<span class="hljs-string">&#x27;/api/users&#x27;</span>,
  15444. {
  15445. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  15446. <span class="hljs-attr">headers</span>: headers
  15447. })
  15448. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  15449. <span class="hljs-keyword">return</span> res.json();
  15450. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  15451. <span class="hljs-built_in">console</span>.log(body);
  15452. });
  15453. </code></pre>
  15454. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  15455. <span class="hljs-keyword">const</span> headers = {
  15456. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  15457. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15458. };
  15459. fetch(<span class="hljs-string">&#x27;/api/users&#x27;</span>,
  15460. {
  15461. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  15462. <span class="hljs-attr">headers</span>: headers
  15463. })
  15464. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  15465. <span class="hljs-keyword">return</span> res.json();
  15466. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  15467. <span class="hljs-built_in">console</span>.log(body);
  15468. });
  15469. </code></pre>
  15470. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  15471. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  15472. headers = {
  15473. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  15474. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15475. }
  15476. result = RestClient.get <span class="hljs-string">&#x27;/api/users&#x27;</span>,
  15477. <span class="hljs-symbol">params:</span> {
  15478. }, <span class="hljs-symbol">headers:</span> headers
  15479. p JSON.parse(result)
  15480. </code></pre>
  15481. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  15482. headers = {
  15483. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  15484. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15485. }
  15486. r = requests.get(<span class="hljs-string">&#x27;/api/users&#x27;</span>, headers = headers)
  15487. <span class="hljs-built_in">print</span>(r.json())
  15488. </code></pre>
  15489. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/users&quot;</span>);
  15490. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  15491. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  15492. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  15493. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  15494. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  15495. String inputLine;
  15496. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  15497. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  15498. response.append(inputLine);
  15499. }
  15500. in.close();
  15501. System.out.println(response.toString());
  15502. </code></pre>
  15503. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  15504. <span class="hljs-keyword">import</span> (
  15505. <span class="hljs-string">&quot;bytes&quot;</span>
  15506. <span class="hljs-string">&quot;net/http&quot;</span>
  15507. )
  15508. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  15509. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  15510. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  15511. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  15512. }
  15513. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  15514. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/users&quot;</span>, data)
  15515. req.Header = headers
  15516. client := &amp;http.Client{}
  15517. resp, err := client.Do(req)
  15518. <span class="hljs-comment">// ...</span>
  15519. }
  15520. </code></pre>
  15521. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  15522. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  15523. );
  15524. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  15525. <span class="hljs-comment">// Define array of request body.</span>
  15526. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  15527. <span class="hljs-keyword">try</span> {
  15528. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/users&#x27;</span>, <span class="hljs-keyword">array</span>(
  15529. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  15530. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  15531. )
  15532. );
  15533. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  15534. }
  15535. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  15536. <span class="hljs-comment">// handle exception or api errors.</span>
  15537. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  15538. }
  15539. <span class="hljs-comment">// ...</span>
  15540. </code></pre>
  15541. <p><code>GET /api/users</code></p>
  15542. <p><em>return all the users</em></p>
  15543. <p>Only the admin user (the first user) can call the REST API.</p>
  15544. <blockquote>
  15545. <p>Example responses</p>
  15546. </blockquote>
  15547. <blockquote>
  15548. <p>200 Response</p>
  15549. </blockquote>
  15550. <pre class="highlight tab tab-json"><code>[
  15551. {
  15552. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15553. <span class="hljs-attr">&quot;username&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  15554. }
  15555. ]
  15556. </code></pre>
  15557. <h3 id="get_all_users-responses">Responses</h3>
  15558. <table>
  15559. <thead>
  15560. <tr>
  15561. <th>Status</th>
  15562. <th>Meaning</th>
  15563. <th>Description</th>
  15564. <th>Schema</th>
  15565. </tr>
  15566. </thead>
  15567. <tbody>
  15568. <tr>
  15569. <td>200</td>
  15570. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  15571. <td>200 response</td>
  15572. <td>Inline</td>
  15573. </tr>
  15574. </tbody>
  15575. </table>
  15576. <h3 id="get_all_users-responseschema">Response Schema</h3>
  15577. <p>Status Code <strong>200</strong></p>
  15578. <table>
  15579. <thead>
  15580. <tr>
  15581. <th>Name</th>
  15582. <th>Type</th>
  15583. <th>Required</th>
  15584. <th>Restrictions</th>
  15585. <th>Description</th>
  15586. </tr>
  15587. </thead>
  15588. <tbody>
  15589. <tr>
  15590. <td>» _id</td>
  15591. <td>string</td>
  15592. <td>false</td>
  15593. <td>none</td>
  15594. <td>none</td>
  15595. </tr>
  15596. <tr>
  15597. <td>» username</td>
  15598. <td>string</td>
  15599. <td>false</td>
  15600. <td>none</td>
  15601. <td>none</td>
  15602. </tr>
  15603. </tbody>
  15604. </table>
  15605. <aside class="warning">
  15606. To perform this operation, you must be authenticated by means of one of the following methods:
  15607. UserSecurity
  15608. </aside>
  15609. <h2 id="new_user">new_user</h2>
  15610. <p><a id="opIdnew_user"></a></p>
  15611. <blockquote>
  15612. <p>Code samples</p>
  15613. </blockquote>
  15614. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  15615. curl -X POST /api/users \
  15616. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  15617. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  15618. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  15619. </code></pre>
  15620. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/users</span> <span class="hljs-meta">HTTP/1.1</span>
  15621. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  15622. Accept: application/json
  15623. </span></code></pre>
  15624. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  15625. &quot;username&quot;: &quot;string&quot;,
  15626. &quot;email&quot;: &quot;string&quot;,
  15627. &quot;password&quot;: &quot;string&quot;
  15628. }&#x27;</span>;
  15629. <span class="hljs-keyword">const</span> headers = {
  15630. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  15631. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  15632. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15633. };
  15634. fetch(<span class="hljs-string">&#x27;/api/users&#x27;</span>,
  15635. {
  15636. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  15637. <span class="hljs-attr">body</span>: inputBody,
  15638. <span class="hljs-attr">headers</span>: headers
  15639. })
  15640. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  15641. <span class="hljs-keyword">return</span> res.json();
  15642. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  15643. <span class="hljs-built_in">console</span>.log(body);
  15644. });
  15645. </code></pre>
  15646. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  15647. <span class="hljs-keyword">const</span> inputBody = {
  15648. <span class="hljs-string">&quot;username&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15649. <span class="hljs-string">&quot;email&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  15650. <span class="hljs-string">&quot;password&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  15651. };
  15652. <span class="hljs-keyword">const</span> headers = {
  15653. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  15654. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  15655. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15656. };
  15657. fetch(<span class="hljs-string">&#x27;/api/users&#x27;</span>,
  15658. {
  15659. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  15660. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  15661. <span class="hljs-attr">headers</span>: headers
  15662. })
  15663. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  15664. <span class="hljs-keyword">return</span> res.json();
  15665. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  15666. <span class="hljs-built_in">console</span>.log(body);
  15667. });
  15668. </code></pre>
  15669. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  15670. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  15671. headers = {
  15672. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  15673. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  15674. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15675. }
  15676. result = RestClient.post <span class="hljs-string">&#x27;/api/users&#x27;</span>,
  15677. <span class="hljs-symbol">params:</span> {
  15678. }, <span class="hljs-symbol">headers:</span> headers
  15679. p JSON.parse(result)
  15680. </code></pre>
  15681. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  15682. headers = {
  15683. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  15684. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  15685. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15686. }
  15687. r = requests.post(<span class="hljs-string">&#x27;/api/users&#x27;</span>, headers = headers)
  15688. <span class="hljs-built_in">print</span>(r.json())
  15689. </code></pre>
  15690. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/users&quot;</span>);
  15691. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  15692. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  15693. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  15694. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  15695. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  15696. String inputLine;
  15697. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  15698. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  15699. response.append(inputLine);
  15700. }
  15701. in.close();
  15702. System.out.println(response.toString());
  15703. </code></pre>
  15704. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  15705. <span class="hljs-keyword">import</span> (
  15706. <span class="hljs-string">&quot;bytes&quot;</span>
  15707. <span class="hljs-string">&quot;net/http&quot;</span>
  15708. )
  15709. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  15710. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  15711. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  15712. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  15713. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  15714. }
  15715. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  15716. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/users&quot;</span>, data)
  15717. req.Header = headers
  15718. client := &amp;http.Client{}
  15719. resp, err := client.Do(req)
  15720. <span class="hljs-comment">// ...</span>
  15721. }
  15722. </code></pre>
  15723. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  15724. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  15725. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  15726. );
  15727. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  15728. <span class="hljs-comment">// Define array of request body.</span>
  15729. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  15730. <span class="hljs-keyword">try</span> {
  15731. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/users&#x27;</span>, <span class="hljs-keyword">array</span>(
  15732. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  15733. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  15734. )
  15735. );
  15736. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  15737. }
  15738. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  15739. <span class="hljs-comment">// handle exception or api errors.</span>
  15740. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  15741. }
  15742. <span class="hljs-comment">// ...</span>
  15743. </code></pre>
  15744. <p><code>POST /api/users</code></p>
  15745. <p><em>Create a new user</em></p>
  15746. <p>Only the admin user (the first user) can call the REST API.</p>
  15747. <blockquote>
  15748. <p>Body parameter</p>
  15749. </blockquote>
  15750. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">username:</span> <span class="hljs-string">string</span>
  15751. <span class="hljs-attr">email:</span> <span class="hljs-string">string</span>
  15752. <span class="hljs-attr">password:</span> <span class="hljs-string">string</span>
  15753. </code></pre>
  15754. <h3 id="new_user-parameters">Parameters</h3>
  15755. <table>
  15756. <thead>
  15757. <tr>
  15758. <th>Name</th>
  15759. <th>In</th>
  15760. <th>Type</th>
  15761. <th>Required</th>
  15762. <th>Description</th>
  15763. </tr>
  15764. </thead>
  15765. <tbody>
  15766. <tr>
  15767. <td>body</td>
  15768. <td>body</td>
  15769. <td>object</td>
  15770. <td>true</td>
  15771. <td>none</td>
  15772. </tr>
  15773. <tr>
  15774. <td>» username</td>
  15775. <td>body</td>
  15776. <td>string</td>
  15777. <td>true</td>
  15778. <td>the new username</td>
  15779. </tr>
  15780. <tr>
  15781. <td>» email</td>
  15782. <td>body</td>
  15783. <td>string</td>
  15784. <td>true</td>
  15785. <td>the email of the new user</td>
  15786. </tr>
  15787. <tr>
  15788. <td>» password</td>
  15789. <td>body</td>
  15790. <td>string</td>
  15791. <td>true</td>
  15792. <td>the password of the new user</td>
  15793. </tr>
  15794. </tbody>
  15795. </table>
  15796. <blockquote>
  15797. <p>Example responses</p>
  15798. </blockquote>
  15799. <blockquote>
  15800. <p>200 Response</p>
  15801. </blockquote>
  15802. <pre class="highlight tab tab-json"><code>{
  15803. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  15804. }
  15805. </code></pre>
  15806. <h3 id="new_user-responses">Responses</h3>
  15807. <table>
  15808. <thead>
  15809. <tr>
  15810. <th>Status</th>
  15811. <th>Meaning</th>
  15812. <th>Description</th>
  15813. <th>Schema</th>
  15814. </tr>
  15815. </thead>
  15816. <tbody>
  15817. <tr>
  15818. <td>200</td>
  15819. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  15820. <td>200 response</td>
  15821. <td>Inline</td>
  15822. </tr>
  15823. </tbody>
  15824. </table>
  15825. <h3 id="new_user-responseschema">Response Schema</h3>
  15826. <p>Status Code <strong>200</strong></p>
  15827. <table>
  15828. <thead>
  15829. <tr>
  15830. <th>Name</th>
  15831. <th>Type</th>
  15832. <th>Required</th>
  15833. <th>Restrictions</th>
  15834. <th>Description</th>
  15835. </tr>
  15836. </thead>
  15837. <tbody>
  15838. <tr>
  15839. <td>» _id</td>
  15840. <td>string</td>
  15841. <td>false</td>
  15842. <td>none</td>
  15843. <td>none</td>
  15844. </tr>
  15845. </tbody>
  15846. </table>
  15847. <aside class="warning">
  15848. To perform this operation, you must be authenticated by means of one of the following methods:
  15849. UserSecurity
  15850. </aside>
  15851. <h2 id="get_user">get_user</h2>
  15852. <p><a id="opIdget_user"></a></p>
  15853. <blockquote>
  15854. <p>Code samples</p>
  15855. </blockquote>
  15856. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  15857. curl -X GET /api/users/{user} \
  15858. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  15859. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  15860. </code></pre>
  15861. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/users/{user}</span> <span class="hljs-meta">HTTP/1.1</span>
  15862. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  15863. </span></code></pre>
  15864. <pre class="highlight tab tab-javascript"><code>
  15865. <span class="hljs-keyword">const</span> headers = {
  15866. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  15867. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15868. };
  15869. fetch(<span class="hljs-string">&#x27;/api/users/{user}&#x27;</span>,
  15870. {
  15871. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  15872. <span class="hljs-attr">headers</span>: headers
  15873. })
  15874. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  15875. <span class="hljs-keyword">return</span> res.json();
  15876. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  15877. <span class="hljs-built_in">console</span>.log(body);
  15878. });
  15879. </code></pre>
  15880. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  15881. <span class="hljs-keyword">const</span> headers = {
  15882. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  15883. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15884. };
  15885. fetch(<span class="hljs-string">&#x27;/api/users/{user}&#x27;</span>,
  15886. {
  15887. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  15888. <span class="hljs-attr">headers</span>: headers
  15889. })
  15890. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  15891. <span class="hljs-keyword">return</span> res.json();
  15892. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  15893. <span class="hljs-built_in">console</span>.log(body);
  15894. });
  15895. </code></pre>
  15896. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  15897. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  15898. headers = {
  15899. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  15900. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15901. }
  15902. result = RestClient.get <span class="hljs-string">&#x27;/api/users/{user}&#x27;</span>,
  15903. <span class="hljs-symbol">params:</span> {
  15904. }, <span class="hljs-symbol">headers:</span> headers
  15905. p JSON.parse(result)
  15906. </code></pre>
  15907. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  15908. headers = {
  15909. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  15910. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  15911. }
  15912. r = requests.get(<span class="hljs-string">&#x27;/api/users/{user}&#x27;</span>, headers = headers)
  15913. <span class="hljs-built_in">print</span>(r.json())
  15914. </code></pre>
  15915. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/users/{user}&quot;</span>);
  15916. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  15917. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  15918. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  15919. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  15920. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  15921. String inputLine;
  15922. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  15923. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  15924. response.append(inputLine);
  15925. }
  15926. in.close();
  15927. System.out.println(response.toString());
  15928. </code></pre>
  15929. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  15930. <span class="hljs-keyword">import</span> (
  15931. <span class="hljs-string">&quot;bytes&quot;</span>
  15932. <span class="hljs-string">&quot;net/http&quot;</span>
  15933. )
  15934. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  15935. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  15936. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  15937. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  15938. }
  15939. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  15940. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/users/{user}&quot;</span>, data)
  15941. req.Header = headers
  15942. client := &amp;http.Client{}
  15943. resp, err := client.Do(req)
  15944. <span class="hljs-comment">// ...</span>
  15945. }
  15946. </code></pre>
  15947. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  15948. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  15949. );
  15950. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  15951. <span class="hljs-comment">// Define array of request body.</span>
  15952. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  15953. <span class="hljs-keyword">try</span> {
  15954. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/users/{user}&#x27;</span>, <span class="hljs-keyword">array</span>(
  15955. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  15956. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  15957. )
  15958. );
  15959. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  15960. }
  15961. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  15962. <span class="hljs-comment">// handle exception or api errors.</span>
  15963. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  15964. }
  15965. <span class="hljs-comment">// ...</span>
  15966. </code></pre>
  15967. <p><code>GET /api/users/{user}</code></p>
  15968. <p><em>get a given user</em></p>
  15969. <p>Only the admin user (the first user) can call the REST API.</p>
  15970. <h3 id="get_user-parameters">Parameters</h3>
  15971. <table>
  15972. <thead>
  15973. <tr>
  15974. <th>Name</th>
  15975. <th>In</th>
  15976. <th>Type</th>
  15977. <th>Required</th>
  15978. <th>Description</th>
  15979. </tr>
  15980. </thead>
  15981. <tbody>
  15982. <tr>
  15983. <td>user</td>
  15984. <td>path</td>
  15985. <td>string</td>
  15986. <td>true</td>
  15987. <td>the user ID or username</td>
  15988. </tr>
  15989. </tbody>
  15990. </table>
  15991. <h4 id="detailed-descriptions-47">Detailed descriptions</h4>
  15992. <p><strong>user</strong>: the user ID or username</p>
  15993. <blockquote>
  15994. <p>Example responses</p>
  15995. </blockquote>
  15996. <blockquote>
  15997. <p>200 Response</p>
  15998. </blockquote>
  15999. <pre class="highlight tab tab-json"><code>{
  16000. <span class="hljs-attr">&quot;username&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16001. <span class="hljs-attr">&quot;orgs&quot;</span>: [
  16002. {
  16003. <span class="hljs-attr">&quot;orgId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16004. <span class="hljs-attr">&quot;orgDisplayName&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  16005. }
  16006. ],
  16007. <span class="hljs-attr">&quot;teams&quot;</span>: [
  16008. {
  16009. <span class="hljs-attr">&quot;teamId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16010. <span class="hljs-attr">&quot;teamDisplayName&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  16011. }
  16012. ],
  16013. <span class="hljs-attr">&quot;emails&quot;</span>: [
  16014. {
  16015. <span class="hljs-attr">&quot;address&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16016. <span class="hljs-attr">&quot;verified&quot;</span>: <span class="hljs-literal">true</span>
  16017. }
  16018. ],
  16019. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16020. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16021. <span class="hljs-attr">&quot;profile&quot;</span>: {
  16022. <span class="hljs-attr">&quot;avatarUrl&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16023. <span class="hljs-attr">&quot;emailBuffer&quot;</span>: [
  16024. <span class="hljs-string">&quot;string&quot;</span>
  16025. ],
  16026. <span class="hljs-attr">&quot;fullname&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16027. <span class="hljs-attr">&quot;showDesktopDragHandles&quot;</span>: <span class="hljs-literal">true</span>,
  16028. <span class="hljs-attr">&quot;hideCheckedItems&quot;</span>: <span class="hljs-literal">true</span>,
  16029. <span class="hljs-attr">&quot;cardMaximized&quot;</span>: <span class="hljs-literal">true</span>,
  16030. <span class="hljs-attr">&quot;customFieldsGrid&quot;</span>: <span class="hljs-literal">true</span>,
  16031. <span class="hljs-attr">&quot;hiddenSystemMessages&quot;</span>: <span class="hljs-literal">true</span>,
  16032. <span class="hljs-attr">&quot;hiddenMinicardLabelText&quot;</span>: <span class="hljs-literal">true</span>,
  16033. <span class="hljs-attr">&quot;initials&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16034. <span class="hljs-attr">&quot;invitedBoards&quot;</span>: [
  16035. <span class="hljs-string">&quot;string&quot;</span>
  16036. ],
  16037. <span class="hljs-attr">&quot;language&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16038. <span class="hljs-attr">&quot;moveAndCopyDialog&quot;</span>: {},
  16039. <span class="hljs-attr">&quot;moveChecklistDialog&quot;</span>: {},
  16040. <span class="hljs-attr">&quot;copyChecklistDialog&quot;</span>: {},
  16041. <span class="hljs-attr">&quot;notifications&quot;</span>: [
  16042. {
  16043. <span class="hljs-attr">&quot;activity&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16044. <span class="hljs-attr">&quot;read&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  16045. }
  16046. ],
  16047. <span class="hljs-attr">&quot;rescueCardDescription&quot;</span>: <span class="hljs-literal">true</span>,
  16048. <span class="hljs-attr">&quot;showCardsCountAt&quot;</span>: <span class="hljs-number">0</span>,
  16049. <span class="hljs-attr">&quot;startDayOfWeek&quot;</span>: <span class="hljs-number">0</span>,
  16050. <span class="hljs-attr">&quot;starredBoards&quot;</span>: [
  16051. <span class="hljs-string">&quot;string&quot;</span>
  16052. ],
  16053. <span class="hljs-attr">&quot;icode&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16054. <span class="hljs-attr">&quot;boardView&quot;</span>: <span class="hljs-string">&quot;board-view-swimlanes&quot;</span>,
  16055. <span class="hljs-attr">&quot;listSortBy&quot;</span>: <span class="hljs-string">&quot;-modifiedat&quot;</span>,
  16056. <span class="hljs-attr">&quot;templatesBoardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16057. <span class="hljs-attr">&quot;cardTemplatesSwimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16058. <span class="hljs-attr">&quot;listTemplatesSwimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16059. <span class="hljs-attr">&quot;boardTemplatesSwimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  16060. },
  16061. <span class="hljs-attr">&quot;services&quot;</span>: {},
  16062. <span class="hljs-attr">&quot;heartbeat&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16063. <span class="hljs-attr">&quot;isAdmin&quot;</span>: <span class="hljs-literal">true</span>,
  16064. <span class="hljs-attr">&quot;createdThroughApi&quot;</span>: <span class="hljs-literal">true</span>,
  16065. <span class="hljs-attr">&quot;loginDisabled&quot;</span>: <span class="hljs-literal">true</span>,
  16066. <span class="hljs-attr">&quot;authenticationMethod&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16067. <span class="hljs-attr">&quot;sessionData&quot;</span>: {
  16068. <span class="hljs-attr">&quot;totalHits&quot;</span>: <span class="hljs-number">0</span>
  16069. },
  16070. <span class="hljs-attr">&quot;importUsernames&quot;</span>: [
  16071. <span class="hljs-string">&quot;string&quot;</span>
  16072. ],
  16073. <span class="hljs-attr">&quot;lastConnectionDate&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  16074. }
  16075. </code></pre>
  16076. <h3 id="get_user-responses">Responses</h3>
  16077. <table>
  16078. <thead>
  16079. <tr>
  16080. <th>Status</th>
  16081. <th>Meaning</th>
  16082. <th>Description</th>
  16083. <th>Schema</th>
  16084. </tr>
  16085. </thead>
  16086. <tbody>
  16087. <tr>
  16088. <td>200</td>
  16089. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  16090. <td>200 response</td>
  16091. <td><a href="#schemausers">Users</a></td>
  16092. </tr>
  16093. </tbody>
  16094. </table>
  16095. <aside class="warning">
  16096. To perform this operation, you must be authenticated by means of one of the following methods:
  16097. UserSecurity
  16098. </aside>
  16099. <h2 id="edit_user">edit_user</h2>
  16100. <p><a id="opIdedit_user"></a></p>
  16101. <blockquote>
  16102. <p>Code samples</p>
  16103. </blockquote>
  16104. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  16105. curl -X PUT /api/users/{user} \
  16106. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  16107. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  16108. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  16109. </code></pre>
  16110. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">PUT</span> <span class="hljs-string">/api/users/{user}</span> <span class="hljs-meta">HTTP/1.1</span>
  16111. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  16112. Accept: application/json
  16113. </span></code></pre>
  16114. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  16115. &quot;action&quot;: &quot;string&quot;
  16116. }&#x27;</span>;
  16117. <span class="hljs-keyword">const</span> headers = {
  16118. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  16119. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  16120. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  16121. };
  16122. fetch(<span class="hljs-string">&#x27;/api/users/{user}&#x27;</span>,
  16123. {
  16124. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;PUT&#x27;</span>,
  16125. <span class="hljs-attr">body</span>: inputBody,
  16126. <span class="hljs-attr">headers</span>: headers
  16127. })
  16128. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  16129. <span class="hljs-keyword">return</span> res.json();
  16130. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  16131. <span class="hljs-built_in">console</span>.log(body);
  16132. });
  16133. </code></pre>
  16134. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  16135. <span class="hljs-keyword">const</span> inputBody = {
  16136. <span class="hljs-string">&quot;action&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  16137. };
  16138. <span class="hljs-keyword">const</span> headers = {
  16139. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  16140. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  16141. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  16142. };
  16143. fetch(<span class="hljs-string">&#x27;/api/users/{user}&#x27;</span>,
  16144. {
  16145. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;PUT&#x27;</span>,
  16146. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  16147. <span class="hljs-attr">headers</span>: headers
  16148. })
  16149. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  16150. <span class="hljs-keyword">return</span> res.json();
  16151. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  16152. <span class="hljs-built_in">console</span>.log(body);
  16153. });
  16154. </code></pre>
  16155. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  16156. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  16157. headers = {
  16158. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  16159. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  16160. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  16161. }
  16162. result = RestClient.put <span class="hljs-string">&#x27;/api/users/{user}&#x27;</span>,
  16163. <span class="hljs-symbol">params:</span> {
  16164. }, <span class="hljs-symbol">headers:</span> headers
  16165. p JSON.parse(result)
  16166. </code></pre>
  16167. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  16168. headers = {
  16169. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  16170. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  16171. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  16172. }
  16173. r = requests.put(<span class="hljs-string">&#x27;/api/users/{user}&#x27;</span>, headers = headers)
  16174. <span class="hljs-built_in">print</span>(r.json())
  16175. </code></pre>
  16176. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/users/{user}&quot;</span>);
  16177. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  16178. con.setRequestMethod(<span class="hljs-string">&quot;PUT&quot;</span>);
  16179. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  16180. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  16181. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  16182. String inputLine;
  16183. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  16184. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  16185. response.append(inputLine);
  16186. }
  16187. in.close();
  16188. System.out.println(response.toString());
  16189. </code></pre>
  16190. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  16191. <span class="hljs-keyword">import</span> (
  16192. <span class="hljs-string">&quot;bytes&quot;</span>
  16193. <span class="hljs-string">&quot;net/http&quot;</span>
  16194. )
  16195. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  16196. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  16197. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  16198. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  16199. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  16200. }
  16201. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  16202. req, err := http.NewRequest(<span class="hljs-string">&quot;PUT&quot;</span>, <span class="hljs-string">&quot;/api/users/{user}&quot;</span>, data)
  16203. req.Header = headers
  16204. client := &amp;http.Client{}
  16205. resp, err := client.Do(req)
  16206. <span class="hljs-comment">// ...</span>
  16207. }
  16208. </code></pre>
  16209. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  16210. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  16211. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  16212. );
  16213. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  16214. <span class="hljs-comment">// Define array of request body.</span>
  16215. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  16216. <span class="hljs-keyword">try</span> {
  16217. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;PUT&#x27;</span>,<span class="hljs-string">&#x27;/api/users/{user}&#x27;</span>, <span class="hljs-keyword">array</span>(
  16218. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  16219. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  16220. )
  16221. );
  16222. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  16223. }
  16224. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  16225. <span class="hljs-comment">// handle exception or api errors.</span>
  16226. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  16227. }
  16228. <span class="hljs-comment">// ...</span>
  16229. </code></pre>
  16230. <p><code>PUT /api/users/{user}</code></p>
  16231. <p><em>edit a given user</em></p>
  16232. <p>Only the admin user (the first user) can call the REST API.</p>
  16233. <p>Possible values for <em>action</em>:</p>
  16234. <ul>
  16235. <li><code>takeOwnership</code>: The admin takes the ownership of ALL boards of the user (archived and not archived) where the user is admin on.</li>
  16236. <li><code>disableLogin</code>: Disable a user (the user is not allowed to login and his login tokens are purged)</li>
  16237. <li><code>enableLogin</code>: Enable a user</li>
  16238. </ul>
  16239. <blockquote>
  16240. <p>Body parameter</p>
  16241. </blockquote>
  16242. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">action:</span> <span class="hljs-string">string</span>
  16243. </code></pre>
  16244. <h3 id="edit_user-parameters">Parameters</h3>
  16245. <table>
  16246. <thead>
  16247. <tr>
  16248. <th>Name</th>
  16249. <th>In</th>
  16250. <th>Type</th>
  16251. <th>Required</th>
  16252. <th>Description</th>
  16253. </tr>
  16254. </thead>
  16255. <tbody>
  16256. <tr>
  16257. <td>user</td>
  16258. <td>path</td>
  16259. <td>string</td>
  16260. <td>true</td>
  16261. <td>the user ID</td>
  16262. </tr>
  16263. <tr>
  16264. <td>body</td>
  16265. <td>body</td>
  16266. <td>object</td>
  16267. <td>true</td>
  16268. <td>none</td>
  16269. </tr>
  16270. <tr>
  16271. <td>» action</td>
  16272. <td>body</td>
  16273. <td>string</td>
  16274. <td>true</td>
  16275. <td>the action</td>
  16276. </tr>
  16277. </tbody>
  16278. </table>
  16279. <h4 id="detailed-descriptions-48">Detailed descriptions</h4>
  16280. <p><strong>user</strong>: the user ID</p>
  16281. <blockquote>
  16282. <p>Example responses</p>
  16283. </blockquote>
  16284. <blockquote>
  16285. <p>200 Response</p>
  16286. </blockquote>
  16287. <pre class="highlight tab tab-json"><code>{
  16288. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16289. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  16290. }
  16291. </code></pre>
  16292. <h3 id="edit_user-responses">Responses</h3>
  16293. <table>
  16294. <thead>
  16295. <tr>
  16296. <th>Status</th>
  16297. <th>Meaning</th>
  16298. <th>Description</th>
  16299. <th>Schema</th>
  16300. </tr>
  16301. </thead>
  16302. <tbody>
  16303. <tr>
  16304. <td>200</td>
  16305. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  16306. <td>200 response</td>
  16307. <td>Inline</td>
  16308. </tr>
  16309. </tbody>
  16310. </table>
  16311. <h3 id="edit_user-responseschema">Response Schema</h3>
  16312. <p>Status Code <strong>200</strong></p>
  16313. <table>
  16314. <thead>
  16315. <tr>
  16316. <th>Name</th>
  16317. <th>Type</th>
  16318. <th>Required</th>
  16319. <th>Restrictions</th>
  16320. <th>Description</th>
  16321. </tr>
  16322. </thead>
  16323. <tbody>
  16324. <tr>
  16325. <td>» _id</td>
  16326. <td>string</td>
  16327. <td>false</td>
  16328. <td>none</td>
  16329. <td>none</td>
  16330. </tr>
  16331. <tr>
  16332. <td>» title</td>
  16333. <td>string</td>
  16334. <td>false</td>
  16335. <td>none</td>
  16336. <td>none</td>
  16337. </tr>
  16338. </tbody>
  16339. </table>
  16340. <aside class="warning">
  16341. To perform this operation, you must be authenticated by means of one of the following methods:
  16342. UserSecurity
  16343. </aside>
  16344. <h2 id="delete_user">delete_user</h2>
  16345. <p><a id="opIddelete_user"></a></p>
  16346. <blockquote>
  16347. <p>Code samples</p>
  16348. </blockquote>
  16349. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  16350. curl -X DELETE /api/users/{user} \
  16351. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  16352. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  16353. </code></pre>
  16354. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">DELETE</span> <span class="hljs-string">/api/users/{user}</span> <span class="hljs-meta">HTTP/1.1</span>
  16355. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  16356. </span></code></pre>
  16357. <pre class="highlight tab tab-javascript"><code>
  16358. <span class="hljs-keyword">const</span> headers = {
  16359. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  16360. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  16361. };
  16362. fetch(<span class="hljs-string">&#x27;/api/users/{user}&#x27;</span>,
  16363. {
  16364. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  16365. <span class="hljs-attr">headers</span>: headers
  16366. })
  16367. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  16368. <span class="hljs-keyword">return</span> res.json();
  16369. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  16370. <span class="hljs-built_in">console</span>.log(body);
  16371. });
  16372. </code></pre>
  16373. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  16374. <span class="hljs-keyword">const</span> headers = {
  16375. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  16376. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  16377. };
  16378. fetch(<span class="hljs-string">&#x27;/api/users/{user}&#x27;</span>,
  16379. {
  16380. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  16381. <span class="hljs-attr">headers</span>: headers
  16382. })
  16383. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  16384. <span class="hljs-keyword">return</span> res.json();
  16385. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  16386. <span class="hljs-built_in">console</span>.log(body);
  16387. });
  16388. </code></pre>
  16389. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  16390. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  16391. headers = {
  16392. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  16393. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  16394. }
  16395. result = RestClient.delete <span class="hljs-string">&#x27;/api/users/{user}&#x27;</span>,
  16396. <span class="hljs-symbol">params:</span> {
  16397. }, <span class="hljs-symbol">headers:</span> headers
  16398. p JSON.parse(result)
  16399. </code></pre>
  16400. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  16401. headers = {
  16402. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  16403. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  16404. }
  16405. r = requests.delete(<span class="hljs-string">&#x27;/api/users/{user}&#x27;</span>, headers = headers)
  16406. <span class="hljs-built_in">print</span>(r.json())
  16407. </code></pre>
  16408. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/users/{user}&quot;</span>);
  16409. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  16410. con.setRequestMethod(<span class="hljs-string">&quot;DELETE&quot;</span>);
  16411. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  16412. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  16413. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  16414. String inputLine;
  16415. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  16416. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  16417. response.append(inputLine);
  16418. }
  16419. in.close();
  16420. System.out.println(response.toString());
  16421. </code></pre>
  16422. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  16423. <span class="hljs-keyword">import</span> (
  16424. <span class="hljs-string">&quot;bytes&quot;</span>
  16425. <span class="hljs-string">&quot;net/http&quot;</span>
  16426. )
  16427. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  16428. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  16429. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  16430. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  16431. }
  16432. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  16433. req, err := http.NewRequest(<span class="hljs-string">&quot;DELETE&quot;</span>, <span class="hljs-string">&quot;/api/users/{user}&quot;</span>, data)
  16434. req.Header = headers
  16435. client := &amp;http.Client{}
  16436. resp, err := client.Do(req)
  16437. <span class="hljs-comment">// ...</span>
  16438. }
  16439. </code></pre>
  16440. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  16441. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  16442. );
  16443. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  16444. <span class="hljs-comment">// Define array of request body.</span>
  16445. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  16446. <span class="hljs-keyword">try</span> {
  16447. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;DELETE&#x27;</span>,<span class="hljs-string">&#x27;/api/users/{user}&#x27;</span>, <span class="hljs-keyword">array</span>(
  16448. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  16449. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  16450. )
  16451. );
  16452. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  16453. }
  16454. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  16455. <span class="hljs-comment">// handle exception or api errors.</span>
  16456. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  16457. }
  16458. <span class="hljs-comment">// ...</span>
  16459. </code></pre>
  16460. <p><code>DELETE /api/users/{user}</code></p>
  16461. <p><em>Delete a user</em></p>
  16462. <p>Only the admin user (the first user) can call the REST API.</p>
  16463. <h3 id="delete_user-parameters">Parameters</h3>
  16464. <table>
  16465. <thead>
  16466. <tr>
  16467. <th>Name</th>
  16468. <th>In</th>
  16469. <th>Type</th>
  16470. <th>Required</th>
  16471. <th>Description</th>
  16472. </tr>
  16473. </thead>
  16474. <tbody>
  16475. <tr>
  16476. <td>user</td>
  16477. <td>path</td>
  16478. <td>string</td>
  16479. <td>true</td>
  16480. <td>the ID of the user to delete</td>
  16481. </tr>
  16482. </tbody>
  16483. </table>
  16484. <h4 id="detailed-descriptions-49">Detailed descriptions</h4>
  16485. <p><strong>user</strong>: the ID of the user to delete</p>
  16486. <blockquote>
  16487. <p>Example responses</p>
  16488. </blockquote>
  16489. <blockquote>
  16490. <p>200 Response</p>
  16491. </blockquote>
  16492. <pre class="highlight tab tab-json"><code>{
  16493. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  16494. }
  16495. </code></pre>
  16496. <h3 id="delete_user-responses">Responses</h3>
  16497. <table>
  16498. <thead>
  16499. <tr>
  16500. <th>Status</th>
  16501. <th>Meaning</th>
  16502. <th>Description</th>
  16503. <th>Schema</th>
  16504. </tr>
  16505. </thead>
  16506. <tbody>
  16507. <tr>
  16508. <td>200</td>
  16509. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  16510. <td>200 response</td>
  16511. <td>Inline</td>
  16512. </tr>
  16513. </tbody>
  16514. </table>
  16515. <h3 id="delete_user-responseschema">Response Schema</h3>
  16516. <p>Status Code <strong>200</strong></p>
  16517. <table>
  16518. <thead>
  16519. <tr>
  16520. <th>Name</th>
  16521. <th>Type</th>
  16522. <th>Required</th>
  16523. <th>Restrictions</th>
  16524. <th>Description</th>
  16525. </tr>
  16526. </thead>
  16527. <tbody>
  16528. <tr>
  16529. <td>» _id</td>
  16530. <td>string</td>
  16531. <td>false</td>
  16532. <td>none</td>
  16533. <td>none</td>
  16534. </tr>
  16535. </tbody>
  16536. </table>
  16537. <aside class="warning">
  16538. To perform this operation, you must be authenticated by means of one of the following methods:
  16539. UserSecurity
  16540. </aside>
  16541. <h1 id="wekan-rest-api-swimlanes">Swimlanes</h1>
  16542. <h2 id="get_all_swimlanes">get_all_swimlanes</h2>
  16543. <p><a id="opIdget_all_swimlanes"></a></p>
  16544. <blockquote>
  16545. <p>Code samples</p>
  16546. </blockquote>
  16547. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  16548. curl -X GET /api/boards/{board}/swimlanes \
  16549. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  16550. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  16551. </code></pre>
  16552. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/swimlanes</span> <span class="hljs-meta">HTTP/1.1</span>
  16553. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  16554. </span></code></pre>
  16555. <pre class="highlight tab tab-javascript"><code>
  16556. <span class="hljs-keyword">const</span> headers = {
  16557. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  16558. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  16559. };
  16560. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes&#x27;</span>,
  16561. {
  16562. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  16563. <span class="hljs-attr">headers</span>: headers
  16564. })
  16565. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  16566. <span class="hljs-keyword">return</span> res.json();
  16567. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  16568. <span class="hljs-built_in">console</span>.log(body);
  16569. });
  16570. </code></pre>
  16571. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  16572. <span class="hljs-keyword">const</span> headers = {
  16573. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  16574. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  16575. };
  16576. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes&#x27;</span>,
  16577. {
  16578. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  16579. <span class="hljs-attr">headers</span>: headers
  16580. })
  16581. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  16582. <span class="hljs-keyword">return</span> res.json();
  16583. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  16584. <span class="hljs-built_in">console</span>.log(body);
  16585. });
  16586. </code></pre>
  16587. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  16588. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  16589. headers = {
  16590. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  16591. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  16592. }
  16593. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/swimlanes&#x27;</span>,
  16594. <span class="hljs-symbol">params:</span> {
  16595. }, <span class="hljs-symbol">headers:</span> headers
  16596. p JSON.parse(result)
  16597. </code></pre>
  16598. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  16599. headers = {
  16600. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  16601. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  16602. }
  16603. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes&#x27;</span>, headers = headers)
  16604. <span class="hljs-built_in">print</span>(r.json())
  16605. </code></pre>
  16606. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/swimlanes&quot;</span>);
  16607. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  16608. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  16609. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  16610. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  16611. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  16612. String inputLine;
  16613. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  16614. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  16615. response.append(inputLine);
  16616. }
  16617. in.close();
  16618. System.out.println(response.toString());
  16619. </code></pre>
  16620. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  16621. <span class="hljs-keyword">import</span> (
  16622. <span class="hljs-string">&quot;bytes&quot;</span>
  16623. <span class="hljs-string">&quot;net/http&quot;</span>
  16624. )
  16625. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  16626. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  16627. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  16628. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  16629. }
  16630. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  16631. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/swimlanes&quot;</span>, data)
  16632. req.Header = headers
  16633. client := &amp;http.Client{}
  16634. resp, err := client.Do(req)
  16635. <span class="hljs-comment">// ...</span>
  16636. }
  16637. </code></pre>
  16638. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  16639. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  16640. );
  16641. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  16642. <span class="hljs-comment">// Define array of request body.</span>
  16643. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  16644. <span class="hljs-keyword">try</span> {
  16645. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes&#x27;</span>, <span class="hljs-keyword">array</span>(
  16646. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  16647. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  16648. )
  16649. );
  16650. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  16651. }
  16652. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  16653. <span class="hljs-comment">// handle exception or api errors.</span>
  16654. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  16655. }
  16656. <span class="hljs-comment">// ...</span>
  16657. </code></pre>
  16658. <p><code>GET /api/boards/{board}/swimlanes</code></p>
  16659. <p><em>Get the list of swimlanes attached to a board</em></p>
  16660. <h3 id="get_all_swimlanes-parameters">Parameters</h3>
  16661. <table>
  16662. <thead>
  16663. <tr>
  16664. <th>Name</th>
  16665. <th>In</th>
  16666. <th>Type</th>
  16667. <th>Required</th>
  16668. <th>Description</th>
  16669. </tr>
  16670. </thead>
  16671. <tbody>
  16672. <tr>
  16673. <td>board</td>
  16674. <td>path</td>
  16675. <td>string</td>
  16676. <td>true</td>
  16677. <td>the ID of the board</td>
  16678. </tr>
  16679. </tbody>
  16680. </table>
  16681. <h4 id="detailed-descriptions-50">Detailed descriptions</h4>
  16682. <p><strong>board</strong>: the ID of the board</p>
  16683. <blockquote>
  16684. <p>Example responses</p>
  16685. </blockquote>
  16686. <blockquote>
  16687. <p>200 Response</p>
  16688. </blockquote>
  16689. <pre class="highlight tab tab-json"><code>[
  16690. {
  16691. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  16692. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  16693. }
  16694. ]
  16695. </code></pre>
  16696. <h3 id="get_all_swimlanes-responses">Responses</h3>
  16697. <table>
  16698. <thead>
  16699. <tr>
  16700. <th>Status</th>
  16701. <th>Meaning</th>
  16702. <th>Description</th>
  16703. <th>Schema</th>
  16704. </tr>
  16705. </thead>
  16706. <tbody>
  16707. <tr>
  16708. <td>200</td>
  16709. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  16710. <td>200 response</td>
  16711. <td>Inline</td>
  16712. </tr>
  16713. </tbody>
  16714. </table>
  16715. <h3 id="get_all_swimlanes-responseschema">Response Schema</h3>
  16716. <p>Status Code <strong>200</strong></p>
  16717. <table>
  16718. <thead>
  16719. <tr>
  16720. <th>Name</th>
  16721. <th>Type</th>
  16722. <th>Required</th>
  16723. <th>Restrictions</th>
  16724. <th>Description</th>
  16725. </tr>
  16726. </thead>
  16727. <tbody>
  16728. <tr>
  16729. <td>» _id</td>
  16730. <td>string</td>
  16731. <td>false</td>
  16732. <td>none</td>
  16733. <td>none</td>
  16734. </tr>
  16735. <tr>
  16736. <td>» title</td>
  16737. <td>string</td>
  16738. <td>false</td>
  16739. <td>none</td>
  16740. <td>none</td>
  16741. </tr>
  16742. </tbody>
  16743. </table>
  16744. <aside class="warning">
  16745. To perform this operation, you must be authenticated by means of one of the following methods:
  16746. UserSecurity
  16747. </aside>
  16748. <h2 id="new_swimlane">new_swimlane</h2>
  16749. <p><a id="opIdnew_swimlane"></a></p>
  16750. <blockquote>
  16751. <p>Code samples</p>
  16752. </blockquote>
  16753. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  16754. curl -X POST /api/boards/{board}/swimlanes \
  16755. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  16756. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  16757. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  16758. </code></pre>
  16759. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">POST</span> <span class="hljs-string">/api/boards/{board}/swimlanes</span> <span class="hljs-meta">HTTP/1.1</span>
  16760. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  16761. Accept: application/json
  16762. </span></code></pre>
  16763. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  16764. &quot;title&quot;: &quot;string&quot;
  16765. }&#x27;</span>;
  16766. <span class="hljs-keyword">const</span> headers = {
  16767. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  16768. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  16769. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  16770. };
  16771. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes&#x27;</span>,
  16772. {
  16773. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  16774. <span class="hljs-attr">body</span>: inputBody,
  16775. <span class="hljs-attr">headers</span>: headers
  16776. })
  16777. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  16778. <span class="hljs-keyword">return</span> res.json();
  16779. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  16780. <span class="hljs-built_in">console</span>.log(body);
  16781. });
  16782. </code></pre>
  16783. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  16784. <span class="hljs-keyword">const</span> inputBody = {
  16785. <span class="hljs-string">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  16786. };
  16787. <span class="hljs-keyword">const</span> headers = {
  16788. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  16789. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  16790. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  16791. };
  16792. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes&#x27;</span>,
  16793. {
  16794. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;POST&#x27;</span>,
  16795. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  16796. <span class="hljs-attr">headers</span>: headers
  16797. })
  16798. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  16799. <span class="hljs-keyword">return</span> res.json();
  16800. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  16801. <span class="hljs-built_in">console</span>.log(body);
  16802. });
  16803. </code></pre>
  16804. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  16805. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  16806. headers = {
  16807. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  16808. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  16809. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  16810. }
  16811. result = RestClient.post <span class="hljs-string">&#x27;/api/boards/{board}/swimlanes&#x27;</span>,
  16812. <span class="hljs-symbol">params:</span> {
  16813. }, <span class="hljs-symbol">headers:</span> headers
  16814. p JSON.parse(result)
  16815. </code></pre>
  16816. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  16817. headers = {
  16818. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  16819. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  16820. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  16821. }
  16822. r = requests.post(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes&#x27;</span>, headers = headers)
  16823. <span class="hljs-built_in">print</span>(r.json())
  16824. </code></pre>
  16825. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/swimlanes&quot;</span>);
  16826. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  16827. con.setRequestMethod(<span class="hljs-string">&quot;POST&quot;</span>);
  16828. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  16829. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  16830. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  16831. String inputLine;
  16832. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  16833. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  16834. response.append(inputLine);
  16835. }
  16836. in.close();
  16837. System.out.println(response.toString());
  16838. </code></pre>
  16839. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  16840. <span class="hljs-keyword">import</span> (
  16841. <span class="hljs-string">&quot;bytes&quot;</span>
  16842. <span class="hljs-string">&quot;net/http&quot;</span>
  16843. )
  16844. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  16845. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  16846. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  16847. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  16848. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  16849. }
  16850. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  16851. req, err := http.NewRequest(<span class="hljs-string">&quot;POST&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/swimlanes&quot;</span>, data)
  16852. req.Header = headers
  16853. client := &amp;http.Client{}
  16854. resp, err := client.Do(req)
  16855. <span class="hljs-comment">// ...</span>
  16856. }
  16857. </code></pre>
  16858. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  16859. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  16860. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  16861. );
  16862. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  16863. <span class="hljs-comment">// Define array of request body.</span>
  16864. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  16865. <span class="hljs-keyword">try</span> {
  16866. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;POST&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes&#x27;</span>, <span class="hljs-keyword">array</span>(
  16867. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  16868. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  16869. )
  16870. );
  16871. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  16872. }
  16873. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  16874. <span class="hljs-comment">// handle exception or api errors.</span>
  16875. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  16876. }
  16877. <span class="hljs-comment">// ...</span>
  16878. </code></pre>
  16879. <p><code>POST /api/boards/{board}/swimlanes</code></p>
  16880. <p><em>Add a swimlane to a board</em></p>
  16881. <blockquote>
  16882. <p>Body parameter</p>
  16883. </blockquote>
  16884. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">title:</span> <span class="hljs-string">string</span>
  16885. </code></pre>
  16886. <h3 id="new_swimlane-parameters">Parameters</h3>
  16887. <table>
  16888. <thead>
  16889. <tr>
  16890. <th>Name</th>
  16891. <th>In</th>
  16892. <th>Type</th>
  16893. <th>Required</th>
  16894. <th>Description</th>
  16895. </tr>
  16896. </thead>
  16897. <tbody>
  16898. <tr>
  16899. <td>board</td>
  16900. <td>path</td>
  16901. <td>string</td>
  16902. <td>true</td>
  16903. <td>the ID of the board</td>
  16904. </tr>
  16905. <tr>
  16906. <td>body</td>
  16907. <td>body</td>
  16908. <td>object</td>
  16909. <td>true</td>
  16910. <td>none</td>
  16911. </tr>
  16912. <tr>
  16913. <td>» title</td>
  16914. <td>body</td>
  16915. <td>string</td>
  16916. <td>true</td>
  16917. <td>the new title of the swimlane</td>
  16918. </tr>
  16919. </tbody>
  16920. </table>
  16921. <h4 id="detailed-descriptions-51">Detailed descriptions</h4>
  16922. <p><strong>board</strong>: the ID of the board</p>
  16923. <blockquote>
  16924. <p>Example responses</p>
  16925. </blockquote>
  16926. <blockquote>
  16927. <p>200 Response</p>
  16928. </blockquote>
  16929. <pre class="highlight tab tab-json"><code>{
  16930. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  16931. }
  16932. </code></pre>
  16933. <h3 id="new_swimlane-responses">Responses</h3>
  16934. <table>
  16935. <thead>
  16936. <tr>
  16937. <th>Status</th>
  16938. <th>Meaning</th>
  16939. <th>Description</th>
  16940. <th>Schema</th>
  16941. </tr>
  16942. </thead>
  16943. <tbody>
  16944. <tr>
  16945. <td>200</td>
  16946. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  16947. <td>200 response</td>
  16948. <td>Inline</td>
  16949. </tr>
  16950. </tbody>
  16951. </table>
  16952. <h3 id="new_swimlane-responseschema">Response Schema</h3>
  16953. <p>Status Code <strong>200</strong></p>
  16954. <table>
  16955. <thead>
  16956. <tr>
  16957. <th>Name</th>
  16958. <th>Type</th>
  16959. <th>Required</th>
  16960. <th>Restrictions</th>
  16961. <th>Description</th>
  16962. </tr>
  16963. </thead>
  16964. <tbody>
  16965. <tr>
  16966. <td>» _id</td>
  16967. <td>string</td>
  16968. <td>false</td>
  16969. <td>none</td>
  16970. <td>none</td>
  16971. </tr>
  16972. </tbody>
  16973. </table>
  16974. <aside class="warning">
  16975. To perform this operation, you must be authenticated by means of one of the following methods:
  16976. UserSecurity
  16977. </aside>
  16978. <h2 id="get_swimlane">get_swimlane</h2>
  16979. <p><a id="opIdget_swimlane"></a></p>
  16980. <blockquote>
  16981. <p>Code samples</p>
  16982. </blockquote>
  16983. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  16984. curl -X GET /api/boards/{board}/swimlanes/{swimlane} \
  16985. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  16986. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  16987. </code></pre>
  16988. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">GET</span> <span class="hljs-string">/api/boards/{board}/swimlanes/{swimlane}</span> <span class="hljs-meta">HTTP/1.1</span>
  16989. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  16990. </span></code></pre>
  16991. <pre class="highlight tab tab-javascript"><code>
  16992. <span class="hljs-keyword">const</span> headers = {
  16993. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  16994. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  16995. };
  16996. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}&#x27;</span>,
  16997. {
  16998. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  16999. <span class="hljs-attr">headers</span>: headers
  17000. })
  17001. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  17002. <span class="hljs-keyword">return</span> res.json();
  17003. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  17004. <span class="hljs-built_in">console</span>.log(body);
  17005. });
  17006. </code></pre>
  17007. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  17008. <span class="hljs-keyword">const</span> headers = {
  17009. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  17010. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  17011. };
  17012. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}&#x27;</span>,
  17013. {
  17014. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;GET&#x27;</span>,
  17015. <span class="hljs-attr">headers</span>: headers
  17016. })
  17017. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  17018. <span class="hljs-keyword">return</span> res.json();
  17019. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  17020. <span class="hljs-built_in">console</span>.log(body);
  17021. });
  17022. </code></pre>
  17023. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  17024. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  17025. headers = {
  17026. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  17027. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  17028. }
  17029. result = RestClient.get <span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}&#x27;</span>,
  17030. <span class="hljs-symbol">params:</span> {
  17031. }, <span class="hljs-symbol">headers:</span> headers
  17032. p JSON.parse(result)
  17033. </code></pre>
  17034. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  17035. headers = {
  17036. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  17037. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  17038. }
  17039. r = requests.get(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}&#x27;</span>, headers = headers)
  17040. <span class="hljs-built_in">print</span>(r.json())
  17041. </code></pre>
  17042. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/swimlanes/{swimlane}&quot;</span>);
  17043. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  17044. con.setRequestMethod(<span class="hljs-string">&quot;GET&quot;</span>);
  17045. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  17046. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  17047. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  17048. String inputLine;
  17049. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  17050. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  17051. response.append(inputLine);
  17052. }
  17053. in.close();
  17054. System.out.println(response.toString());
  17055. </code></pre>
  17056. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  17057. <span class="hljs-keyword">import</span> (
  17058. <span class="hljs-string">&quot;bytes&quot;</span>
  17059. <span class="hljs-string">&quot;net/http&quot;</span>
  17060. )
  17061. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  17062. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  17063. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  17064. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  17065. }
  17066. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  17067. req, err := http.NewRequest(<span class="hljs-string">&quot;GET&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/swimlanes/{swimlane}&quot;</span>, data)
  17068. req.Header = headers
  17069. client := &amp;http.Client{}
  17070. resp, err := client.Do(req)
  17071. <span class="hljs-comment">// ...</span>
  17072. }
  17073. </code></pre>
  17074. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  17075. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  17076. );
  17077. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  17078. <span class="hljs-comment">// Define array of request body.</span>
  17079. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  17080. <span class="hljs-keyword">try</span> {
  17081. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;GET&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}&#x27;</span>, <span class="hljs-keyword">array</span>(
  17082. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  17083. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  17084. )
  17085. );
  17086. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  17087. }
  17088. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  17089. <span class="hljs-comment">// handle exception or api errors.</span>
  17090. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  17091. }
  17092. <span class="hljs-comment">// ...</span>
  17093. </code></pre>
  17094. <p><code>GET /api/boards/{board}/swimlanes/{swimlane}</code></p>
  17095. <p><em>Get a swimlane</em></p>
  17096. <h3 id="get_swimlane-parameters">Parameters</h3>
  17097. <table>
  17098. <thead>
  17099. <tr>
  17100. <th>Name</th>
  17101. <th>In</th>
  17102. <th>Type</th>
  17103. <th>Required</th>
  17104. <th>Description</th>
  17105. </tr>
  17106. </thead>
  17107. <tbody>
  17108. <tr>
  17109. <td>board</td>
  17110. <td>path</td>
  17111. <td>string</td>
  17112. <td>true</td>
  17113. <td>the ID of the board</td>
  17114. </tr>
  17115. <tr>
  17116. <td>swimlane</td>
  17117. <td>path</td>
  17118. <td>string</td>
  17119. <td>true</td>
  17120. <td>the ID of the swimlane</td>
  17121. </tr>
  17122. </tbody>
  17123. </table>
  17124. <h4 id="detailed-descriptions-52">Detailed descriptions</h4>
  17125. <p><strong>board</strong>: the ID of the board</p>
  17126. <p><strong>swimlane</strong>: the ID of the swimlane</p>
  17127. <blockquote>
  17128. <p>Example responses</p>
  17129. </blockquote>
  17130. <blockquote>
  17131. <p>200 Response</p>
  17132. </blockquote>
  17133. <pre class="highlight tab tab-json"><code>{
  17134. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17135. <span class="hljs-attr">&quot;archived&quot;</span>: <span class="hljs-literal">true</span>,
  17136. <span class="hljs-attr">&quot;archivedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17137. <span class="hljs-attr">&quot;boardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17138. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17139. <span class="hljs-attr">&quot;sort&quot;</span>: <span class="hljs-number">0</span>,
  17140. <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;white&quot;</span>,
  17141. <span class="hljs-attr">&quot;updatedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17142. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17143. <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  17144. }
  17145. </code></pre>
  17146. <h3 id="get_swimlane-responses">Responses</h3>
  17147. <table>
  17148. <thead>
  17149. <tr>
  17150. <th>Status</th>
  17151. <th>Meaning</th>
  17152. <th>Description</th>
  17153. <th>Schema</th>
  17154. </tr>
  17155. </thead>
  17156. <tbody>
  17157. <tr>
  17158. <td>200</td>
  17159. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  17160. <td>200 response</td>
  17161. <td><a href="#schemaswimlanes">Swimlanes</a></td>
  17162. </tr>
  17163. </tbody>
  17164. </table>
  17165. <aside class="warning">
  17166. To perform this operation, you must be authenticated by means of one of the following methods:
  17167. UserSecurity
  17168. </aside>
  17169. <h2 id="edit_swimlane">edit_swimlane</h2>
  17170. <p><a id="opIdedit_swimlane"></a></p>
  17171. <blockquote>
  17172. <p>Code samples</p>
  17173. </blockquote>
  17174. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  17175. curl -X PUT /api/boards/{board}/swimlanes/{swimlane} \
  17176. -H <span class="hljs-string">&#x27;Content-Type: multipart/form-data&#x27;</span> \
  17177. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  17178. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  17179. </code></pre>
  17180. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">PUT</span> <span class="hljs-string">/api/boards/{board}/swimlanes/{swimlane}</span> <span class="hljs-meta">HTTP/1.1</span>
  17181. <span class="fortran">Content-<span class="hljs-keyword">Type</span>: multipart/<span class="hljs-keyword">form</span>-<span class="hljs-keyword">data</span>
  17182. Accept: application/json
  17183. </span></code></pre>
  17184. <pre class="highlight tab tab-javascript"><code><span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">&#x27;{
  17185. &quot;title&quot;: &quot;string&quot;
  17186. }&#x27;</span>;
  17187. <span class="hljs-keyword">const</span> headers = {
  17188. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  17189. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  17190. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  17191. };
  17192. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}&#x27;</span>,
  17193. {
  17194. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;PUT&#x27;</span>,
  17195. <span class="hljs-attr">body</span>: inputBody,
  17196. <span class="hljs-attr">headers</span>: headers
  17197. })
  17198. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  17199. <span class="hljs-keyword">return</span> res.json();
  17200. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  17201. <span class="hljs-built_in">console</span>.log(body);
  17202. });
  17203. </code></pre>
  17204. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  17205. <span class="hljs-keyword">const</span> inputBody = {
  17206. <span class="hljs-string">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  17207. };
  17208. <span class="hljs-keyword">const</span> headers = {
  17209. <span class="hljs-string">&#x27;Content-Type&#x27;</span>:<span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  17210. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  17211. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  17212. };
  17213. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}&#x27;</span>,
  17214. {
  17215. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;PUT&#x27;</span>,
  17216. <span class="hljs-attr">body</span>: <span class="hljs-built_in">JSON</span>.stringify(inputBody),
  17217. <span class="hljs-attr">headers</span>: headers
  17218. })
  17219. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  17220. <span class="hljs-keyword">return</span> res.json();
  17221. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  17222. <span class="hljs-built_in">console</span>.log(body);
  17223. });
  17224. </code></pre>
  17225. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  17226. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  17227. headers = {
  17228. <span class="hljs-string">&#x27;Content-Type&#x27;</span> =&gt; <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  17229. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  17230. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  17231. }
  17232. result = RestClient.put <span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}&#x27;</span>,
  17233. <span class="hljs-symbol">params:</span> {
  17234. }, <span class="hljs-symbol">headers:</span> headers
  17235. p JSON.parse(result)
  17236. </code></pre>
  17237. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  17238. headers = {
  17239. <span class="hljs-string">&#x27;Content-Type&#x27;</span>: <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  17240. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  17241. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  17242. }
  17243. r = requests.put(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}&#x27;</span>, headers = headers)
  17244. <span class="hljs-built_in">print</span>(r.json())
  17245. </code></pre>
  17246. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/swimlanes/{swimlane}&quot;</span>);
  17247. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  17248. con.setRequestMethod(<span class="hljs-string">&quot;PUT&quot;</span>);
  17249. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  17250. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  17251. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  17252. String inputLine;
  17253. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  17254. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  17255. response.append(inputLine);
  17256. }
  17257. in.close();
  17258. System.out.println(response.toString());
  17259. </code></pre>
  17260. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  17261. <span class="hljs-keyword">import</span> (
  17262. <span class="hljs-string">&quot;bytes&quot;</span>
  17263. <span class="hljs-string">&quot;net/http&quot;</span>
  17264. )
  17265. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  17266. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  17267. <span class="hljs-string">&quot;Content-Type&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;multipart/form-data&quot;</span>},
  17268. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  17269. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  17270. }
  17271. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  17272. req, err := http.NewRequest(<span class="hljs-string">&quot;PUT&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/swimlanes/{swimlane}&quot;</span>, data)
  17273. req.Header = headers
  17274. client := &amp;http.Client{}
  17275. resp, err := client.Do(req)
  17276. <span class="hljs-comment">// ...</span>
  17277. }
  17278. </code></pre>
  17279. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;multipart/form-data&#x27;</span>,
  17280. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  17281. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  17282. );
  17283. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  17284. <span class="hljs-comment">// Define array of request body.</span>
  17285. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  17286. <span class="hljs-keyword">try</span> {
  17287. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;PUT&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}&#x27;</span>, <span class="hljs-keyword">array</span>(
  17288. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  17289. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  17290. )
  17291. );
  17292. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  17293. }
  17294. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  17295. <span class="hljs-comment">// handle exception or api errors.</span>
  17296. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  17297. }
  17298. <span class="hljs-comment">// ...</span>
  17299. </code></pre>
  17300. <p><code>PUT /api/boards/{board}/swimlanes/{swimlane}</code></p>
  17301. <p><em>Edit the title of a swimlane</em></p>
  17302. <blockquote>
  17303. <p>Body parameter</p>
  17304. </blockquote>
  17305. <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">title:</span> <span class="hljs-string">string</span>
  17306. </code></pre>
  17307. <h3 id="edit_swimlane-parameters">Parameters</h3>
  17308. <table>
  17309. <thead>
  17310. <tr>
  17311. <th>Name</th>
  17312. <th>In</th>
  17313. <th>Type</th>
  17314. <th>Required</th>
  17315. <th>Description</th>
  17316. </tr>
  17317. </thead>
  17318. <tbody>
  17319. <tr>
  17320. <td>board</td>
  17321. <td>path</td>
  17322. <td>string</td>
  17323. <td>true</td>
  17324. <td>the ID of the board</td>
  17325. </tr>
  17326. <tr>
  17327. <td>swimlane</td>
  17328. <td>path</td>
  17329. <td>string</td>
  17330. <td>true</td>
  17331. <td>the ID of the swimlane to edit</td>
  17332. </tr>
  17333. <tr>
  17334. <td>body</td>
  17335. <td>body</td>
  17336. <td>object</td>
  17337. <td>true</td>
  17338. <td>none</td>
  17339. </tr>
  17340. <tr>
  17341. <td>» title</td>
  17342. <td>body</td>
  17343. <td>string</td>
  17344. <td>true</td>
  17345. <td>the new title of the swimlane</td>
  17346. </tr>
  17347. </tbody>
  17348. </table>
  17349. <h4 id="detailed-descriptions-53">Detailed descriptions</h4>
  17350. <p><strong>board</strong>: the ID of the board</p>
  17351. <p><strong>swimlane</strong>: the ID of the swimlane to edit</p>
  17352. <blockquote>
  17353. <p>Example responses</p>
  17354. </blockquote>
  17355. <blockquote>
  17356. <p>200 Response</p>
  17357. </blockquote>
  17358. <pre class="highlight tab tab-json"><code>{
  17359. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  17360. }
  17361. </code></pre>
  17362. <h3 id="edit_swimlane-responses">Responses</h3>
  17363. <table>
  17364. <thead>
  17365. <tr>
  17366. <th>Status</th>
  17367. <th>Meaning</th>
  17368. <th>Description</th>
  17369. <th>Schema</th>
  17370. </tr>
  17371. </thead>
  17372. <tbody>
  17373. <tr>
  17374. <td>200</td>
  17375. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  17376. <td>200 response</td>
  17377. <td>Inline</td>
  17378. </tr>
  17379. </tbody>
  17380. </table>
  17381. <h3 id="edit_swimlane-responseschema">Response Schema</h3>
  17382. <p>Status Code <strong>200</strong></p>
  17383. <table>
  17384. <thead>
  17385. <tr>
  17386. <th>Name</th>
  17387. <th>Type</th>
  17388. <th>Required</th>
  17389. <th>Restrictions</th>
  17390. <th>Description</th>
  17391. </tr>
  17392. </thead>
  17393. <tbody>
  17394. <tr>
  17395. <td>» _id</td>
  17396. <td>string</td>
  17397. <td>false</td>
  17398. <td>none</td>
  17399. <td>none</td>
  17400. </tr>
  17401. </tbody>
  17402. </table>
  17403. <aside class="warning">
  17404. To perform this operation, you must be authenticated by means of one of the following methods:
  17405. UserSecurity
  17406. </aside>
  17407. <h2 id="delete_swimlane">delete_swimlane</h2>
  17408. <p><a id="opIddelete_swimlane"></a></p>
  17409. <blockquote>
  17410. <p>Code samples</p>
  17411. </blockquote>
  17412. <pre class="highlight tab tab-shell"><code><span class="hljs-comment"># You can also use wget</span>
  17413. curl -X DELETE /api/boards/{board}/swimlanes/{swimlane} \
  17414. -H <span class="hljs-string">&#x27;Accept: application/json&#x27;</span> \
  17415. -H <span class="hljs-string">&#x27;Authorization: API_KEY&#x27;</span>
  17416. </code></pre>
  17417. <pre class="highlight tab tab-http"><code><span class="hljs-keyword">DELETE</span> <span class="hljs-string">/api/boards/{board}/swimlanes/{swimlane}</span> <span class="hljs-meta">HTTP/1.1</span>
  17418. <span class="ada"><span class="hljs-keyword">Accept</span>: application/json
  17419. </span></code></pre>
  17420. <pre class="highlight tab tab-javascript"><code>
  17421. <span class="hljs-keyword">const</span> headers = {
  17422. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  17423. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  17424. };
  17425. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}&#x27;</span>,
  17426. {
  17427. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  17428. <span class="hljs-attr">headers</span>: headers
  17429. })
  17430. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  17431. <span class="hljs-keyword">return</span> res.json();
  17432. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  17433. <span class="hljs-built_in">console</span>.log(body);
  17434. });
  17435. </code></pre>
  17436. <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">&#x27;node-fetch&#x27;</span>);
  17437. <span class="hljs-keyword">const</span> headers = {
  17438. <span class="hljs-string">&#x27;Accept&#x27;</span>:<span class="hljs-string">&#x27;application/json&#x27;</span>,
  17439. <span class="hljs-string">&#x27;Authorization&#x27;</span>:<span class="hljs-string">&#x27;API_KEY&#x27;</span>
  17440. };
  17441. fetch(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}&#x27;</span>,
  17442. {
  17443. <span class="hljs-attr">method</span>: <span class="hljs-string">&#x27;DELETE&#x27;</span>,
  17444. <span class="hljs-attr">headers</span>: headers
  17445. })
  17446. .then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">res</span>) </span>{
  17447. <span class="hljs-keyword">return</span> res.json();
  17448. }).then(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">body</span>) </span>{
  17449. <span class="hljs-built_in">console</span>.log(body);
  17450. });
  17451. </code></pre>
  17452. <pre class="highlight tab tab-ruby"><code><span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;rest-client&#x27;</span>
  17453. <span class="hljs-keyword">require</span> <span class="hljs-string">&#x27;json&#x27;</span>
  17454. headers = {
  17455. <span class="hljs-string">&#x27;Accept&#x27;</span> =&gt; <span class="hljs-string">&#x27;application/json&#x27;</span>,
  17456. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  17457. }
  17458. result = RestClient.delete <span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}&#x27;</span>,
  17459. <span class="hljs-symbol">params:</span> {
  17460. }, <span class="hljs-symbol">headers:</span> headers
  17461. p JSON.parse(result)
  17462. </code></pre>
  17463. <pre class="highlight tab tab-python"><code><span class="hljs-keyword">import</span> requests
  17464. headers = {
  17465. <span class="hljs-string">&#x27;Accept&#x27;</span>: <span class="hljs-string">&#x27;application/json&#x27;</span>,
  17466. <span class="hljs-string">&#x27;Authorization&#x27;</span>: <span class="hljs-string">&#x27;API_KEY&#x27;</span>
  17467. }
  17468. r = requests.delete(<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}&#x27;</span>, headers = headers)
  17469. <span class="hljs-built_in">print</span>(r.json())
  17470. </code></pre>
  17471. <pre class="highlight tab tab-java"><code>URL obj = <span class="hljs-keyword">new</span> URL(<span class="hljs-string">&quot;/api/boards/{board}/swimlanes/{swimlane}&quot;</span>);
  17472. HttpURLConnection con = (HttpURLConnection) obj.openConnection();
  17473. con.setRequestMethod(<span class="hljs-string">&quot;DELETE&quot;</span>);
  17474. <span class="hljs-keyword">int</span> responseCode = con.getResponseCode();
  17475. BufferedReader in = <span class="hljs-keyword">new</span> BufferedReader(
  17476. <span class="hljs-keyword">new</span> InputStreamReader(con.getInputStream()));
  17477. String inputLine;
  17478. StringBuffer response = <span class="hljs-keyword">new</span> StringBuffer();
  17479. <span class="hljs-keyword">while</span> ((inputLine = in.readLine()) != <span class="hljs-keyword">null</span>) {
  17480. response.append(inputLine);
  17481. }
  17482. in.close();
  17483. System.out.println(response.toString());
  17484. </code></pre>
  17485. <pre class="highlight tab tab-go"><code><span class="hljs-keyword">package</span> main
  17486. <span class="hljs-keyword">import</span> (
  17487. <span class="hljs-string">&quot;bytes&quot;</span>
  17488. <span class="hljs-string">&quot;net/http&quot;</span>
  17489. )
  17490. <span class="hljs-function"><span class="hljs-keyword">func</span> <span class="hljs-title">main</span><span class="hljs-params">()</span></span> {
  17491. headers := <span class="hljs-keyword">map</span>[<span class="hljs-keyword">string</span>][]<span class="hljs-keyword">string</span>{
  17492. <span class="hljs-string">&quot;Accept&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;application/json&quot;</span>},
  17493. <span class="hljs-string">&quot;Authorization&quot;</span>: []<span class="hljs-keyword">string</span>{<span class="hljs-string">&quot;API_KEY&quot;</span>},
  17494. }
  17495. data := bytes.NewBuffer([]<span class="hljs-keyword">byte</span>{jsonReq})
  17496. req, err := http.NewRequest(<span class="hljs-string">&quot;DELETE&quot;</span>, <span class="hljs-string">&quot;/api/boards/{board}/swimlanes/{swimlane}&quot;</span>, data)
  17497. req.Header = headers
  17498. client := &amp;http.Client{}
  17499. resp, err := client.Do(req)
  17500. <span class="hljs-comment">// ...</span>
  17501. }
  17502. </code></pre>
  17503. <pre class="highlight tab tab-php"><code> <span class="hljs-string">&#x27;application/json&#x27;</span>,
  17504. <span class="hljs-string">&#x27;Authorization&#x27;</span> =&gt; <span class="hljs-string">&#x27;API_KEY&#x27;</span>,
  17505. );
  17506. <span class="hljs-variable">$client</span> = <span class="hljs-keyword">new</span> \GuzzleHttp\Client();
  17507. <span class="hljs-comment">// Define array of request body.</span>
  17508. <span class="hljs-variable">$request_body</span> = <span class="hljs-keyword">array</span>();
  17509. <span class="hljs-keyword">try</span> {
  17510. <span class="hljs-variable">$response</span> = <span class="hljs-variable">$client</span>-&gt;request(<span class="hljs-string">&#x27;DELETE&#x27;</span>,<span class="hljs-string">&#x27;/api/boards/{board}/swimlanes/{swimlane}&#x27;</span>, <span class="hljs-keyword">array</span>(
  17511. <span class="hljs-string">&#x27;headers&#x27;</span> =&gt; <span class="hljs-variable">$headers</span>,
  17512. <span class="hljs-string">&#x27;json&#x27;</span> =&gt; <span class="hljs-variable">$request_body</span>,
  17513. )
  17514. );
  17515. print_r(<span class="hljs-variable">$response</span>-&gt;getBody()-&gt;getContents());
  17516. }
  17517. <span class="hljs-keyword">catch</span> (\GuzzleHttp\<span class="hljs-built_in">Exception</span>\BadResponseException <span class="hljs-variable">$e</span>) {
  17518. <span class="hljs-comment">// handle exception or api errors.</span>
  17519. print_r(<span class="hljs-variable">$e</span>-&gt;getMessage());
  17520. }
  17521. <span class="hljs-comment">// ...</span>
  17522. </code></pre>
  17523. <p><code>DELETE /api/boards/{board}/swimlanes/{swimlane}</code></p>
  17524. <p><em>Delete a swimlane</em></p>
  17525. <p>The swimlane will be deleted, not moved to the recycle bin</p>
  17526. <h3 id="delete_swimlane-parameters">Parameters</h3>
  17527. <table>
  17528. <thead>
  17529. <tr>
  17530. <th>Name</th>
  17531. <th>In</th>
  17532. <th>Type</th>
  17533. <th>Required</th>
  17534. <th>Description</th>
  17535. </tr>
  17536. </thead>
  17537. <tbody>
  17538. <tr>
  17539. <td>board</td>
  17540. <td>path</td>
  17541. <td>string</td>
  17542. <td>true</td>
  17543. <td>the ID of the board</td>
  17544. </tr>
  17545. <tr>
  17546. <td>swimlane</td>
  17547. <td>path</td>
  17548. <td>string</td>
  17549. <td>true</td>
  17550. <td>the ID of the swimlane</td>
  17551. </tr>
  17552. </tbody>
  17553. </table>
  17554. <h4 id="detailed-descriptions-54">Detailed descriptions</h4>
  17555. <p><strong>board</strong>: the ID of the board</p>
  17556. <p><strong>swimlane</strong>: the ID of the swimlane</p>
  17557. <blockquote>
  17558. <p>Example responses</p>
  17559. </blockquote>
  17560. <blockquote>
  17561. <p>200 Response</p>
  17562. </blockquote>
  17563. <pre class="highlight tab tab-json"><code>{
  17564. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  17565. }
  17566. </code></pre>
  17567. <h3 id="delete_swimlane-responses">Responses</h3>
  17568. <table>
  17569. <thead>
  17570. <tr>
  17571. <th>Status</th>
  17572. <th>Meaning</th>
  17573. <th>Description</th>
  17574. <th>Schema</th>
  17575. </tr>
  17576. </thead>
  17577. <tbody>
  17578. <tr>
  17579. <td>200</td>
  17580. <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td>
  17581. <td>200 response</td>
  17582. <td>Inline</td>
  17583. </tr>
  17584. </tbody>
  17585. </table>
  17586. <h3 id="delete_swimlane-responseschema">Response Schema</h3>
  17587. <p>Status Code <strong>200</strong></p>
  17588. <table>
  17589. <thead>
  17590. <tr>
  17591. <th>Name</th>
  17592. <th>Type</th>
  17593. <th>Required</th>
  17594. <th>Restrictions</th>
  17595. <th>Description</th>
  17596. </tr>
  17597. </thead>
  17598. <tbody>
  17599. <tr>
  17600. <td>» _id</td>
  17601. <td>string</td>
  17602. <td>false</td>
  17603. <td>none</td>
  17604. <td>none</td>
  17605. </tr>
  17606. </tbody>
  17607. </table>
  17608. <aside class="warning">
  17609. To perform this operation, you must be authenticated by means of one of the following methods:
  17610. UserSecurity
  17611. </aside>
  17612. <h1 id="schemas">Schemas</h1>
  17613. <h2 id="tocs_boards">Boards</h2>
  17614. <p><a id="schemaboards"></a>
  17615. <a id="schema_Boards"></a>
  17616. <a id="tocSboards"></a>
  17617. <a id="tocsboards"></a></p>
  17618. <pre class="highlight tab tab-json"><code>{
  17619. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17620. <span class="hljs-attr">&quot;slug&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17621. <span class="hljs-attr">&quot;archived&quot;</span>: <span class="hljs-literal">true</span>,
  17622. <span class="hljs-attr">&quot;archivedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17623. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17624. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17625. <span class="hljs-attr">&quot;stars&quot;</span>: <span class="hljs-number">0</span>,
  17626. <span class="hljs-attr">&quot;labels&quot;</span>: [
  17627. {
  17628. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17629. <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17630. <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;white&quot;</span>
  17631. }
  17632. ],
  17633. <span class="hljs-attr">&quot;members&quot;</span>: [
  17634. {
  17635. <span class="hljs-attr">&quot;userId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17636. <span class="hljs-attr">&quot;isAdmin&quot;</span>: <span class="hljs-literal">true</span>,
  17637. <span class="hljs-attr">&quot;isActive&quot;</span>: <span class="hljs-literal">true</span>,
  17638. <span class="hljs-attr">&quot;isNoComments&quot;</span>: <span class="hljs-literal">true</span>,
  17639. <span class="hljs-attr">&quot;isCommentOnly&quot;</span>: <span class="hljs-literal">true</span>,
  17640. <span class="hljs-attr">&quot;isWorker&quot;</span>: <span class="hljs-literal">true</span>
  17641. }
  17642. ],
  17643. <span class="hljs-attr">&quot;permission&quot;</span>: <span class="hljs-string">&quot;public&quot;</span>,
  17644. <span class="hljs-attr">&quot;orgs&quot;</span>: [
  17645. {
  17646. <span class="hljs-attr">&quot;orgId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17647. <span class="hljs-attr">&quot;orgDisplayName&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17648. <span class="hljs-attr">&quot;isActive&quot;</span>: <span class="hljs-literal">true</span>
  17649. }
  17650. ],
  17651. <span class="hljs-attr">&quot;teams&quot;</span>: [
  17652. {
  17653. <span class="hljs-attr">&quot;teamId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17654. <span class="hljs-attr">&quot;teamDisplayName&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17655. <span class="hljs-attr">&quot;isActive&quot;</span>: <span class="hljs-literal">true</span>
  17656. }
  17657. ],
  17658. <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;belize&quot;</span>,
  17659. <span class="hljs-attr">&quot;backgroundImageURL&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17660. <span class="hljs-attr">&quot;allowsCardCounterList&quot;</span>: <span class="hljs-literal">true</span>,
  17661. <span class="hljs-attr">&quot;allowsBoardMemberList&quot;</span>: <span class="hljs-literal">true</span>,
  17662. <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17663. <span class="hljs-attr">&quot;subtasksDefaultBoardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17664. <span class="hljs-attr">&quot;subtasksDefaultListId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17665. <span class="hljs-attr">&quot;dateSettingsDefaultBoardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17666. <span class="hljs-attr">&quot;dateSettingsDefaultListId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17667. <span class="hljs-attr">&quot;allowsSubtasks&quot;</span>: <span class="hljs-literal">true</span>,
  17668. <span class="hljs-attr">&quot;allowsAttachments&quot;</span>: <span class="hljs-literal">true</span>,
  17669. <span class="hljs-attr">&quot;allowsChecklists&quot;</span>: <span class="hljs-literal">true</span>,
  17670. <span class="hljs-attr">&quot;allowsComments&quot;</span>: <span class="hljs-literal">true</span>,
  17671. <span class="hljs-attr">&quot;allowsDescriptionTitle&quot;</span>: <span class="hljs-literal">true</span>,
  17672. <span class="hljs-attr">&quot;allowsDescriptionText&quot;</span>: <span class="hljs-literal">true</span>,
  17673. <span class="hljs-attr">&quot;allowsDescriptionTextOnMinicard&quot;</span>: <span class="hljs-literal">true</span>,
  17674. <span class="hljs-attr">&quot;allowsCoverAttachmentOnMinicard&quot;</span>: <span class="hljs-literal">true</span>,
  17675. <span class="hljs-attr">&quot;allowsBadgeAttachmentOnMinicard&quot;</span>: <span class="hljs-literal">true</span>,
  17676. <span class="hljs-attr">&quot;allowsCardSortingByNumberOnMinicard&quot;</span>: <span class="hljs-literal">true</span>,
  17677. <span class="hljs-attr">&quot;allowsCardNumber&quot;</span>: <span class="hljs-literal">true</span>,
  17678. <span class="hljs-attr">&quot;allowsActivities&quot;</span>: <span class="hljs-literal">true</span>,
  17679. <span class="hljs-attr">&quot;allowsLabels&quot;</span>: <span class="hljs-literal">true</span>,
  17680. <span class="hljs-attr">&quot;allowsCreator&quot;</span>: <span class="hljs-literal">true</span>,
  17681. <span class="hljs-attr">&quot;allowsAssignee&quot;</span>: <span class="hljs-literal">true</span>,
  17682. <span class="hljs-attr">&quot;allowsMembers&quot;</span>: <span class="hljs-literal">true</span>,
  17683. <span class="hljs-attr">&quot;allowsRequestedBy&quot;</span>: <span class="hljs-literal">true</span>,
  17684. <span class="hljs-attr">&quot;allowsCardSortingByNumber&quot;</span>: <span class="hljs-literal">true</span>,
  17685. <span class="hljs-attr">&quot;allowsShowLists&quot;</span>: <span class="hljs-literal">true</span>,
  17686. <span class="hljs-attr">&quot;allowsAssignedBy&quot;</span>: <span class="hljs-literal">true</span>,
  17687. <span class="hljs-attr">&quot;allowsReceivedDate&quot;</span>: <span class="hljs-literal">true</span>,
  17688. <span class="hljs-attr">&quot;allowsStartDate&quot;</span>: <span class="hljs-literal">true</span>,
  17689. <span class="hljs-attr">&quot;allowsEndDate&quot;</span>: <span class="hljs-literal">true</span>,
  17690. <span class="hljs-attr">&quot;allowsDueDate&quot;</span>: <span class="hljs-literal">true</span>,
  17691. <span class="hljs-attr">&quot;presentParentTask&quot;</span>: <span class="hljs-string">&quot;prefix-with-full-path&quot;</span>,
  17692. <span class="hljs-attr">&quot;receivedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17693. <span class="hljs-attr">&quot;startAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17694. <span class="hljs-attr">&quot;dueAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17695. <span class="hljs-attr">&quot;endAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  17696. <span class="hljs-attr">&quot;spentTime&quot;</span>: <span class="hljs-number">0</span>,
  17697. <span class="hljs-attr">&quot;isOvertime&quot;</span>: <span class="hljs-literal">true</span>,
  17698. <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;board&quot;</span>,
  17699. <span class="hljs-attr">&quot;sort&quot;</span>: <span class="hljs-number">0</span>
  17700. }
  17701. </code></pre>
  17702. <p>This is a Board.</p>
  17703. <h3 id="properties">Properties</h3>
  17704. <table>
  17705. <thead>
  17706. <tr>
  17707. <th>Name</th>
  17708. <th>Type</th>
  17709. <th>Required</th>
  17710. <th>Restrictions</th>
  17711. <th>Description</th>
  17712. </tr>
  17713. </thead>
  17714. <tbody>
  17715. <tr>
  17716. <td>title</td>
  17717. <td>string</td>
  17718. <td>true</td>
  17719. <td>none</td>
  17720. <td>The title of the board</td>
  17721. </tr>
  17722. <tr>
  17723. <td>slug</td>
  17724. <td>string</td>
  17725. <td>true</td>
  17726. <td>none</td>
  17727. <td>The title slugified.</td>
  17728. </tr>
  17729. <tr>
  17730. <td>archived</td>
  17731. <td>boolean</td>
  17732. <td>true</td>
  17733. <td>none</td>
  17734. <td>Is the board archived?</td>
  17735. </tr>
  17736. <tr>
  17737. <td>archivedAt</td>
  17738. <td>string¦null</td>
  17739. <td>false</td>
  17740. <td>none</td>
  17741. <td>Latest archiving time of the board</td>
  17742. </tr>
  17743. <tr>
  17744. <td>createdAt</td>
  17745. <td>string</td>
  17746. <td>true</td>
  17747. <td>none</td>
  17748. <td>Creation time of the board</td>
  17749. </tr>
  17750. <tr>
  17751. <td>modifiedAt</td>
  17752. <td>string¦null</td>
  17753. <td>false</td>
  17754. <td>none</td>
  17755. <td>Last modification time of the board</td>
  17756. </tr>
  17757. <tr>
  17758. <td>stars</td>
  17759. <td>number</td>
  17760. <td>true</td>
  17761. <td>none</td>
  17762. <td>How many stars the board has</td>
  17763. </tr>
  17764. <tr>
  17765. <td>labels</td>
  17766. <td>[<a href="#schemaboardslabels">BoardsLabels</a>]¦null</td>
  17767. <td>false</td>
  17768. <td>none</td>
  17769. <td>List of labels attached to a board</td>
  17770. </tr>
  17771. <tr>
  17772. <td>members</td>
  17773. <td>[<a href="#schemaboardsmembers">BoardsMembers</a>]</td>
  17774. <td>true</td>
  17775. <td>none</td>
  17776. <td>List of members of a board</td>
  17777. </tr>
  17778. <tr>
  17779. <td>permission</td>
  17780. <td>string</td>
  17781. <td>true</td>
  17782. <td>none</td>
  17783. <td>visibility of the board</td>
  17784. </tr>
  17785. <tr>
  17786. <td>orgs</td>
  17787. <td>[<a href="#schemaboardsorgs">BoardsOrgs</a>]¦null</td>
  17788. <td>false</td>
  17789. <td>none</td>
  17790. <td>the list of organizations that a board belongs to</td>
  17791. </tr>
  17792. <tr>
  17793. <td>teams</td>
  17794. <td>[<a href="#schemaboardsteams">BoardsTeams</a>]¦null</td>
  17795. <td>false</td>
  17796. <td>none</td>
  17797. <td>the list of teams that a board belongs to</td>
  17798. </tr>
  17799. <tr>
  17800. <td>color</td>
  17801. <td>string</td>
  17802. <td>true</td>
  17803. <td>none</td>
  17804. <td>The color of the board.</td>
  17805. </tr>
  17806. <tr>
  17807. <td>backgroundImageURL</td>
  17808. <td>string¦null</td>
  17809. <td>false</td>
  17810. <td>none</td>
  17811. <td>The background image URL of the board.</td>
  17812. </tr>
  17813. <tr>
  17814. <td>allowsCardCounterList</td>
  17815. <td>boolean</td>
  17816. <td>true</td>
  17817. <td>none</td>
  17818. <td>Show card counter per list</td>
  17819. </tr>
  17820. <tr>
  17821. <td>allowsBoardMemberList</td>
  17822. <td>boolean</td>
  17823. <td>true</td>
  17824. <td>none</td>
  17825. <td>Show board member list</td>
  17826. </tr>
  17827. <tr>
  17828. <td>description</td>
  17829. <td>string¦null</td>
  17830. <td>false</td>
  17831. <td>none</td>
  17832. <td>The description of the board</td>
  17833. </tr>
  17834. <tr>
  17835. <td>subtasksDefaultBoardId</td>
  17836. <td>string¦null</td>
  17837. <td>false</td>
  17838. <td>none</td>
  17839. <td>The default board ID assigned to subtasks.</td>
  17840. </tr>
  17841. <tr>
  17842. <td>subtasksDefaultListId</td>
  17843. <td>string¦null</td>
  17844. <td>false</td>
  17845. <td>none</td>
  17846. <td>The default List ID assigned to subtasks.</td>
  17847. </tr>
  17848. <tr>
  17849. <td>dateSettingsDefaultBoardId</td>
  17850. <td>string¦null</td>
  17851. <td>false</td>
  17852. <td>none</td>
  17853. <td>none</td>
  17854. </tr>
  17855. <tr>
  17856. <td>dateSettingsDefaultListId</td>
  17857. <td>string¦null</td>
  17858. <td>false</td>
  17859. <td>none</td>
  17860. <td>none</td>
  17861. </tr>
  17862. <tr>
  17863. <td>allowsSubtasks</td>
  17864. <td>boolean</td>
  17865. <td>true</td>
  17866. <td>none</td>
  17867. <td>Does the board allows subtasks?</td>
  17868. </tr>
  17869. <tr>
  17870. <td>allowsAttachments</td>
  17871. <td>boolean</td>
  17872. <td>true</td>
  17873. <td>none</td>
  17874. <td>Does the board allows attachments?</td>
  17875. </tr>
  17876. <tr>
  17877. <td>allowsChecklists</td>
  17878. <td>boolean</td>
  17879. <td>true</td>
  17880. <td>none</td>
  17881. <td>Does the board allows checklists?</td>
  17882. </tr>
  17883. <tr>
  17884. <td>allowsComments</td>
  17885. <td>boolean</td>
  17886. <td>true</td>
  17887. <td>none</td>
  17888. <td>Does the board allows comments?</td>
  17889. </tr>
  17890. <tr>
  17891. <td>allowsDescriptionTitle</td>
  17892. <td>boolean</td>
  17893. <td>true</td>
  17894. <td>none</td>
  17895. <td>Does the board allows description title?</td>
  17896. </tr>
  17897. <tr>
  17898. <td>allowsDescriptionText</td>
  17899. <td>boolean</td>
  17900. <td>true</td>
  17901. <td>none</td>
  17902. <td>Does the board allows description text?</td>
  17903. </tr>
  17904. <tr>
  17905. <td>allowsDescriptionTextOnMinicard</td>
  17906. <td>boolean</td>
  17907. <td>true</td>
  17908. <td>none</td>
  17909. <td>Does the board allows description text on minicard?</td>
  17910. </tr>
  17911. <tr>
  17912. <td>allowsCoverAttachmentOnMinicard</td>
  17913. <td>boolean</td>
  17914. <td>true</td>
  17915. <td>none</td>
  17916. <td>Does the board allows cover attachment on minicard?</td>
  17917. </tr>
  17918. <tr>
  17919. <td>allowsBadgeAttachmentOnMinicard</td>
  17920. <td>boolean</td>
  17921. <td>true</td>
  17922. <td>none</td>
  17923. <td>Does the board allows badge attachment on minicard?</td>
  17924. </tr>
  17925. <tr>
  17926. <td>allowsCardSortingByNumberOnMinicard</td>
  17927. <td>boolean</td>
  17928. <td>true</td>
  17929. <td>none</td>
  17930. <td>Does the board allows card sorting by number on minicard?</td>
  17931. </tr>
  17932. <tr>
  17933. <td>allowsCardNumber</td>
  17934. <td>boolean</td>
  17935. <td>true</td>
  17936. <td>none</td>
  17937. <td>Does the board allows card numbers?</td>
  17938. </tr>
  17939. <tr>
  17940. <td>allowsActivities</td>
  17941. <td>boolean</td>
  17942. <td>true</td>
  17943. <td>none</td>
  17944. <td>Does the board allows comments?</td>
  17945. </tr>
  17946. <tr>
  17947. <td>allowsLabels</td>
  17948. <td>boolean</td>
  17949. <td>true</td>
  17950. <td>none</td>
  17951. <td>Does the board allows labels?</td>
  17952. </tr>
  17953. <tr>
  17954. <td>allowsCreator</td>
  17955. <td>boolean</td>
  17956. <td>true</td>
  17957. <td>none</td>
  17958. <td>Does the board allow creator?</td>
  17959. </tr>
  17960. <tr>
  17961. <td>allowsAssignee</td>
  17962. <td>boolean</td>
  17963. <td>true</td>
  17964. <td>none</td>
  17965. <td>Does the board allows assignee?</td>
  17966. </tr>
  17967. <tr>
  17968. <td>allowsMembers</td>
  17969. <td>boolean</td>
  17970. <td>true</td>
  17971. <td>none</td>
  17972. <td>Does the board allows members?</td>
  17973. </tr>
  17974. <tr>
  17975. <td>allowsRequestedBy</td>
  17976. <td>boolean</td>
  17977. <td>true</td>
  17978. <td>none</td>
  17979. <td>Does the board allows requested by?</td>
  17980. </tr>
  17981. <tr>
  17982. <td>allowsCardSortingByNumber</td>
  17983. <td>boolean</td>
  17984. <td>true</td>
  17985. <td>none</td>
  17986. <td>Does the board allows card sorting by number?</td>
  17987. </tr>
  17988. <tr>
  17989. <td>allowsShowLists</td>
  17990. <td>boolean</td>
  17991. <td>true</td>
  17992. <td>none</td>
  17993. <td>Does the board allows show lists on the card?</td>
  17994. </tr>
  17995. <tr>
  17996. <td>allowsAssignedBy</td>
  17997. <td>boolean</td>
  17998. <td>true</td>
  17999. <td>none</td>
  18000. <td>Does the board allows requested by?</td>
  18001. </tr>
  18002. <tr>
  18003. <td>allowsReceivedDate</td>
  18004. <td>boolean</td>
  18005. <td>true</td>
  18006. <td>none</td>
  18007. <td>Does the board allows received date?</td>
  18008. </tr>
  18009. <tr>
  18010. <td>allowsStartDate</td>
  18011. <td>boolean</td>
  18012. <td>true</td>
  18013. <td>none</td>
  18014. <td>Does the board allows start date?</td>
  18015. </tr>
  18016. <tr>
  18017. <td>allowsEndDate</td>
  18018. <td>boolean</td>
  18019. <td>true</td>
  18020. <td>none</td>
  18021. <td>Does the board allows end date?</td>
  18022. </tr>
  18023. <tr>
  18024. <td>allowsDueDate</td>
  18025. <td>boolean</td>
  18026. <td>true</td>
  18027. <td>none</td>
  18028. <td>Does the board allows due date?</td>
  18029. </tr>
  18030. <tr>
  18031. <td>presentParentTask</td>
  18032. <td>string¦null</td>
  18033. <td>false</td>
  18034. <td>none</td>
  18035. <td>Controls how to present the parent task:<br /><br />- <code>prefix-with-full-path</code>: add a prefix with the full path<br />- <code>prefix-with-parent</code>: add a prefisx with the parent name<br />- <code>subtext-with-full-path</code>: add a subtext with the full path<br />- <code>subtext-with-parent</code>: add a subtext with the parent name<br />- <code>no-parent</code>: does not show the parent at all</td>
  18036. </tr>
  18037. <tr>
  18038. <td>receivedAt</td>
  18039. <td>string¦null</td>
  18040. <td>false</td>
  18041. <td>none</td>
  18042. <td>Date the card was received</td>
  18043. </tr>
  18044. <tr>
  18045. <td>startAt</td>
  18046. <td>string¦null</td>
  18047. <td>false</td>
  18048. <td>none</td>
  18049. <td>Starting date of the board.</td>
  18050. </tr>
  18051. <tr>
  18052. <td>dueAt</td>
  18053. <td>string¦null</td>
  18054. <td>false</td>
  18055. <td>none</td>
  18056. <td>Due date of the board.</td>
  18057. </tr>
  18058. <tr>
  18059. <td>endAt</td>
  18060. <td>string¦null</td>
  18061. <td>false</td>
  18062. <td>none</td>
  18063. <td>End date of the board.</td>
  18064. </tr>
  18065. <tr>
  18066. <td>spentTime</td>
  18067. <td>number¦null</td>
  18068. <td>false</td>
  18069. <td>none</td>
  18070. <td>Time spent in the board.</td>
  18071. </tr>
  18072. <tr>
  18073. <td>isOvertime</td>
  18074. <td>boolean¦null</td>
  18075. <td>false</td>
  18076. <td>none</td>
  18077. <td>Is the board overtimed?</td>
  18078. </tr>
  18079. <tr>
  18080. <td>type</td>
  18081. <td>string</td>
  18082. <td>true</td>
  18083. <td>none</td>
  18084. <td>The type of board<br />possible values: board, template-board, template-container</td>
  18085. </tr>
  18086. <tr>
  18087. <td>sort</td>
  18088. <td>number</td>
  18089. <td>true</td>
  18090. <td>none</td>
  18091. <td>Sort value</td>
  18092. </tr>
  18093. </tbody>
  18094. </table>
  18095. <h4 id="enumerated-values">Enumerated Values</h4>
  18096. <table>
  18097. <thead>
  18098. <tr>
  18099. <th>Property</th>
  18100. <th>Value</th>
  18101. </tr>
  18102. </thead>
  18103. <tbody>
  18104. <tr>
  18105. <td>permission</td>
  18106. <td>public</td>
  18107. </tr>
  18108. <tr>
  18109. <td>permission</td>
  18110. <td>private</td>
  18111. </tr>
  18112. <tr>
  18113. <td>color</td>
  18114. <td>belize</td>
  18115. </tr>
  18116. <tr>
  18117. <td>color</td>
  18118. <td>nephritis</td>
  18119. </tr>
  18120. <tr>
  18121. <td>color</td>
  18122. <td>pomegranate</td>
  18123. </tr>
  18124. <tr>
  18125. <td>color</td>
  18126. <td>pumpkin</td>
  18127. </tr>
  18128. <tr>
  18129. <td>color</td>
  18130. <td>wisteria</td>
  18131. </tr>
  18132. <tr>
  18133. <td>color</td>
  18134. <td>moderatepink</td>
  18135. </tr>
  18136. <tr>
  18137. <td>color</td>
  18138. <td>strongcyan</td>
  18139. </tr>
  18140. <tr>
  18141. <td>color</td>
  18142. <td>limegreen</td>
  18143. </tr>
  18144. <tr>
  18145. <td>color</td>
  18146. <td>midnight</td>
  18147. </tr>
  18148. <tr>
  18149. <td>color</td>
  18150. <td>dark</td>
  18151. </tr>
  18152. <tr>
  18153. <td>color</td>
  18154. <td>relax</td>
  18155. </tr>
  18156. <tr>
  18157. <td>color</td>
  18158. <td>corteza</td>
  18159. </tr>
  18160. <tr>
  18161. <td>color</td>
  18162. <td>clearblue</td>
  18163. </tr>
  18164. <tr>
  18165. <td>color</td>
  18166. <td>natural</td>
  18167. </tr>
  18168. <tr>
  18169. <td>color</td>
  18170. <td>modern</td>
  18171. </tr>
  18172. <tr>
  18173. <td>color</td>
  18174. <td>moderndark</td>
  18175. </tr>
  18176. <tr>
  18177. <td>color</td>
  18178. <td>exodark</td>
  18179. </tr>
  18180. <tr>
  18181. <td>presentParentTask</td>
  18182. <td>prefix-with-full-path</td>
  18183. </tr>
  18184. <tr>
  18185. <td>presentParentTask</td>
  18186. <td>prefix-with-parent</td>
  18187. </tr>
  18188. <tr>
  18189. <td>presentParentTask</td>
  18190. <td>subtext-with-full-path</td>
  18191. </tr>
  18192. <tr>
  18193. <td>presentParentTask</td>
  18194. <td>subtext-with-parent</td>
  18195. </tr>
  18196. <tr>
  18197. <td>presentParentTask</td>
  18198. <td>no-parent</td>
  18199. </tr>
  18200. <tr>
  18201. <td>type</td>
  18202. <td>board</td>
  18203. </tr>
  18204. <tr>
  18205. <td>type</td>
  18206. <td>template-board</td>
  18207. </tr>
  18208. <tr>
  18209. <td>type</td>
  18210. <td>template-container</td>
  18211. </tr>
  18212. </tbody>
  18213. </table>
  18214. <h2 id="tocs_boardslabels">BoardsLabels</h2>
  18215. <p><a id="schemaboardslabels"></a>
  18216. <a id="schema_BoardsLabels"></a>
  18217. <a id="tocSboardslabels"></a>
  18218. <a id="tocsboardslabels"></a></p>
  18219. <pre class="highlight tab tab-json"><code>{
  18220. <span class="hljs-attr">&quot;_id&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18221. <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18222. <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;white&quot;</span>
  18223. }
  18224. </code></pre>
  18225. <h3 id="properties-2">Properties</h3>
  18226. <table>
  18227. <thead>
  18228. <tr>
  18229. <th>Name</th>
  18230. <th>Type</th>
  18231. <th>Required</th>
  18232. <th>Restrictions</th>
  18233. <th>Description</th>
  18234. </tr>
  18235. </thead>
  18236. <tbody>
  18237. <tr>
  18238. <td>_id</td>
  18239. <td>string</td>
  18240. <td>true</td>
  18241. <td>none</td>
  18242. <td>Unique id of a label</td>
  18243. </tr>
  18244. <tr>
  18245. <td>name</td>
  18246. <td>string</td>
  18247. <td>false</td>
  18248. <td>none</td>
  18249. <td>Name of a label</td>
  18250. </tr>
  18251. <tr>
  18252. <td>color</td>
  18253. <td>string</td>
  18254. <td>true</td>
  18255. <td>none</td>
  18256. <td>color of a label.<br /><br />Can be amongst <code>green</code>, <code>yellow</code>, <code>orange</code>, <code>red</code>, <code>purple</code>,<br /><code>blue</code>, <code>sky</code>, <code>lime</code>, <code>pink</code>, <code>black</code>,<br /><code>silver</code>, <code>peachpuff</code>, <code>crimson</code>, <code>plum</code>, <code>darkgreen</code>,<br /><code>slateblue</code>, <code>magenta</code>, <code>gold</code>, <code>navy</code>, <code>gray</code>,<br /><code>saddlebrown</code>, <code>paleturquoise</code>, <code>mistyrose</code>, <code>indigo</code></td>
  18257. </tr>
  18258. </tbody>
  18259. </table>
  18260. <h4 id="enumerated-values-2">Enumerated Values</h4>
  18261. <table>
  18262. <thead>
  18263. <tr>
  18264. <th>Property</th>
  18265. <th>Value</th>
  18266. </tr>
  18267. </thead>
  18268. <tbody>
  18269. <tr>
  18270. <td>color</td>
  18271. <td>white</td>
  18272. </tr>
  18273. <tr>
  18274. <td>color</td>
  18275. <td>green</td>
  18276. </tr>
  18277. <tr>
  18278. <td>color</td>
  18279. <td>yellow</td>
  18280. </tr>
  18281. <tr>
  18282. <td>color</td>
  18283. <td>orange</td>
  18284. </tr>
  18285. <tr>
  18286. <td>color</td>
  18287. <td>red</td>
  18288. </tr>
  18289. <tr>
  18290. <td>color</td>
  18291. <td>purple</td>
  18292. </tr>
  18293. <tr>
  18294. <td>color</td>
  18295. <td>blue</td>
  18296. </tr>
  18297. <tr>
  18298. <td>color</td>
  18299. <td>sky</td>
  18300. </tr>
  18301. <tr>
  18302. <td>color</td>
  18303. <td>lime</td>
  18304. </tr>
  18305. <tr>
  18306. <td>color</td>
  18307. <td>pink</td>
  18308. </tr>
  18309. <tr>
  18310. <td>color</td>
  18311. <td>black</td>
  18312. </tr>
  18313. <tr>
  18314. <td>color</td>
  18315. <td>silver</td>
  18316. </tr>
  18317. <tr>
  18318. <td>color</td>
  18319. <td>peachpuff</td>
  18320. </tr>
  18321. <tr>
  18322. <td>color</td>
  18323. <td>crimson</td>
  18324. </tr>
  18325. <tr>
  18326. <td>color</td>
  18327. <td>plum</td>
  18328. </tr>
  18329. <tr>
  18330. <td>color</td>
  18331. <td>darkgreen</td>
  18332. </tr>
  18333. <tr>
  18334. <td>color</td>
  18335. <td>slateblue</td>
  18336. </tr>
  18337. <tr>
  18338. <td>color</td>
  18339. <td>magenta</td>
  18340. </tr>
  18341. <tr>
  18342. <td>color</td>
  18343. <td>gold</td>
  18344. </tr>
  18345. <tr>
  18346. <td>color</td>
  18347. <td>navy</td>
  18348. </tr>
  18349. <tr>
  18350. <td>color</td>
  18351. <td>gray</td>
  18352. </tr>
  18353. <tr>
  18354. <td>color</td>
  18355. <td>saddlebrown</td>
  18356. </tr>
  18357. <tr>
  18358. <td>color</td>
  18359. <td>paleturquoise</td>
  18360. </tr>
  18361. <tr>
  18362. <td>color</td>
  18363. <td>mistyrose</td>
  18364. </tr>
  18365. <tr>
  18366. <td>color</td>
  18367. <td>indigo</td>
  18368. </tr>
  18369. </tbody>
  18370. </table>
  18371. <h2 id="tocs_boardsmembers">BoardsMembers</h2>
  18372. <p><a id="schemaboardsmembers"></a>
  18373. <a id="schema_BoardsMembers"></a>
  18374. <a id="tocSboardsmembers"></a>
  18375. <a id="tocsboardsmembers"></a></p>
  18376. <pre class="highlight tab tab-json"><code>{
  18377. <span class="hljs-attr">&quot;userId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18378. <span class="hljs-attr">&quot;isAdmin&quot;</span>: <span class="hljs-literal">true</span>,
  18379. <span class="hljs-attr">&quot;isActive&quot;</span>: <span class="hljs-literal">true</span>,
  18380. <span class="hljs-attr">&quot;isNoComments&quot;</span>: <span class="hljs-literal">true</span>,
  18381. <span class="hljs-attr">&quot;isCommentOnly&quot;</span>: <span class="hljs-literal">true</span>,
  18382. <span class="hljs-attr">&quot;isWorker&quot;</span>: <span class="hljs-literal">true</span>
  18383. }
  18384. </code></pre>
  18385. <h3 id="properties-3">Properties</h3>
  18386. <table>
  18387. <thead>
  18388. <tr>
  18389. <th>Name</th>
  18390. <th>Type</th>
  18391. <th>Required</th>
  18392. <th>Restrictions</th>
  18393. <th>Description</th>
  18394. </tr>
  18395. </thead>
  18396. <tbody>
  18397. <tr>
  18398. <td>userId</td>
  18399. <td>string</td>
  18400. <td>true</td>
  18401. <td>none</td>
  18402. <td>The uniq ID of the member</td>
  18403. </tr>
  18404. <tr>
  18405. <td>isAdmin</td>
  18406. <td>boolean</td>
  18407. <td>true</td>
  18408. <td>none</td>
  18409. <td>Is the member an admin of the board?</td>
  18410. </tr>
  18411. <tr>
  18412. <td>isActive</td>
  18413. <td>boolean</td>
  18414. <td>true</td>
  18415. <td>none</td>
  18416. <td>Is the member active?</td>
  18417. </tr>
  18418. <tr>
  18419. <td>isNoComments</td>
  18420. <td>boolean</td>
  18421. <td>false</td>
  18422. <td>none</td>
  18423. <td>Is the member not allowed to make comments</td>
  18424. </tr>
  18425. <tr>
  18426. <td>isCommentOnly</td>
  18427. <td>boolean</td>
  18428. <td>false</td>
  18429. <td>none</td>
  18430. <td>Is the member only allowed to comment on the board</td>
  18431. </tr>
  18432. <tr>
  18433. <td>isWorker</td>
  18434. <td>boolean</td>
  18435. <td>false</td>
  18436. <td>none</td>
  18437. <td>Is the member only allowed to move card, assign himself to card and comment</td>
  18438. </tr>
  18439. </tbody>
  18440. </table>
  18441. <h2 id="tocs_boardsorgs">BoardsOrgs</h2>
  18442. <p><a id="schemaboardsorgs"></a>
  18443. <a id="schema_BoardsOrgs"></a>
  18444. <a id="tocSboardsorgs"></a>
  18445. <a id="tocsboardsorgs"></a></p>
  18446. <pre class="highlight tab tab-json"><code>{
  18447. <span class="hljs-attr">&quot;orgId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18448. <span class="hljs-attr">&quot;orgDisplayName&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18449. <span class="hljs-attr">&quot;isActive&quot;</span>: <span class="hljs-literal">true</span>
  18450. }
  18451. </code></pre>
  18452. <h3 id="properties-4">Properties</h3>
  18453. <table>
  18454. <thead>
  18455. <tr>
  18456. <th>Name</th>
  18457. <th>Type</th>
  18458. <th>Required</th>
  18459. <th>Restrictions</th>
  18460. <th>Description</th>
  18461. </tr>
  18462. </thead>
  18463. <tbody>
  18464. <tr>
  18465. <td>orgId</td>
  18466. <td>string</td>
  18467. <td>true</td>
  18468. <td>none</td>
  18469. <td>The uniq ID of the organization</td>
  18470. </tr>
  18471. <tr>
  18472. <td>orgDisplayName</td>
  18473. <td>string</td>
  18474. <td>true</td>
  18475. <td>none</td>
  18476. <td>The display name of the organization</td>
  18477. </tr>
  18478. <tr>
  18479. <td>isActive</td>
  18480. <td>boolean</td>
  18481. <td>true</td>
  18482. <td>none</td>
  18483. <td>Is the organization active?</td>
  18484. </tr>
  18485. </tbody>
  18486. </table>
  18487. <h2 id="tocs_boardsteams">BoardsTeams</h2>
  18488. <p><a id="schemaboardsteams"></a>
  18489. <a id="schema_BoardsTeams"></a>
  18490. <a id="tocSboardsteams"></a>
  18491. <a id="tocsboardsteams"></a></p>
  18492. <pre class="highlight tab tab-json"><code>{
  18493. <span class="hljs-attr">&quot;teamId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18494. <span class="hljs-attr">&quot;teamDisplayName&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18495. <span class="hljs-attr">&quot;isActive&quot;</span>: <span class="hljs-literal">true</span>
  18496. }
  18497. </code></pre>
  18498. <h3 id="properties-5">Properties</h3>
  18499. <table>
  18500. <thead>
  18501. <tr>
  18502. <th>Name</th>
  18503. <th>Type</th>
  18504. <th>Required</th>
  18505. <th>Restrictions</th>
  18506. <th>Description</th>
  18507. </tr>
  18508. </thead>
  18509. <tbody>
  18510. <tr>
  18511. <td>teamId</td>
  18512. <td>string</td>
  18513. <td>true</td>
  18514. <td>none</td>
  18515. <td>The uniq ID of the team</td>
  18516. </tr>
  18517. <tr>
  18518. <td>teamDisplayName</td>
  18519. <td>string</td>
  18520. <td>true</td>
  18521. <td>none</td>
  18522. <td>The display name of the team</td>
  18523. </tr>
  18524. <tr>
  18525. <td>isActive</td>
  18526. <td>boolean</td>
  18527. <td>true</td>
  18528. <td>none</td>
  18529. <td>Is the team active?</td>
  18530. </tr>
  18531. </tbody>
  18532. </table>
  18533. <h2 id="tocs_cardcomments">CardComments</h2>
  18534. <p><a id="schemacardcomments"></a>
  18535. <a id="schema_CardComments"></a>
  18536. <a id="tocScardcomments"></a>
  18537. <a id="tocscardcomments"></a></p>
  18538. <pre class="highlight tab tab-json"><code>{
  18539. <span class="hljs-attr">&quot;boardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18540. <span class="hljs-attr">&quot;cardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18541. <span class="hljs-attr">&quot;text&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18542. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18543. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18544. <span class="hljs-attr">&quot;userId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  18545. }
  18546. </code></pre>
  18547. <p>A comment on a card</p>
  18548. <h3 id="properties-6">Properties</h3>
  18549. <table>
  18550. <thead>
  18551. <tr>
  18552. <th>Name</th>
  18553. <th>Type</th>
  18554. <th>Required</th>
  18555. <th>Restrictions</th>
  18556. <th>Description</th>
  18557. </tr>
  18558. </thead>
  18559. <tbody>
  18560. <tr>
  18561. <td>boardId</td>
  18562. <td>string</td>
  18563. <td>true</td>
  18564. <td>none</td>
  18565. <td>the board ID</td>
  18566. </tr>
  18567. <tr>
  18568. <td>cardId</td>
  18569. <td>string</td>
  18570. <td>true</td>
  18571. <td>none</td>
  18572. <td>the card ID</td>
  18573. </tr>
  18574. <tr>
  18575. <td>text</td>
  18576. <td>string</td>
  18577. <td>true</td>
  18578. <td>none</td>
  18579. <td>the text of the comment</td>
  18580. </tr>
  18581. <tr>
  18582. <td>createdAt</td>
  18583. <td>string</td>
  18584. <td>true</td>
  18585. <td>none</td>
  18586. <td>when was the comment created</td>
  18587. </tr>
  18588. <tr>
  18589. <td>modifiedAt</td>
  18590. <td>string</td>
  18591. <td>true</td>
  18592. <td>none</td>
  18593. <td>none</td>
  18594. </tr>
  18595. <tr>
  18596. <td>userId</td>
  18597. <td>string</td>
  18598. <td>true</td>
  18599. <td>none</td>
  18600. <td>the author ID of the comment</td>
  18601. </tr>
  18602. </tbody>
  18603. </table>
  18604. <h2 id="tocs_cards">Cards</h2>
  18605. <p><a id="schemacards"></a>
  18606. <a id="schema_Cards"></a>
  18607. <a id="tocScards"></a>
  18608. <a id="tocscards"></a></p>
  18609. <pre class="highlight tab tab-json"><code>{
  18610. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18611. <span class="hljs-attr">&quot;archived&quot;</span>: <span class="hljs-literal">true</span>,
  18612. <span class="hljs-attr">&quot;archivedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18613. <span class="hljs-attr">&quot;parentId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18614. <span class="hljs-attr">&quot;listId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18615. <span class="hljs-attr">&quot;swimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18616. <span class="hljs-attr">&quot;boardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18617. <span class="hljs-attr">&quot;coverId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18618. <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;white&quot;</span>,
  18619. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18620. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18621. <span class="hljs-attr">&quot;customFields&quot;</span>: [
  18622. {}
  18623. ],
  18624. <span class="hljs-attr">&quot;dateLastActivity&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18625. <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18626. <span class="hljs-attr">&quot;requestedBy&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18627. <span class="hljs-attr">&quot;assignedBy&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18628. <span class="hljs-attr">&quot;labelIds&quot;</span>: [
  18629. <span class="hljs-string">&quot;string&quot;</span>
  18630. ],
  18631. <span class="hljs-attr">&quot;members&quot;</span>: [
  18632. <span class="hljs-string">&quot;string&quot;</span>
  18633. ],
  18634. <span class="hljs-attr">&quot;assignees&quot;</span>: [
  18635. <span class="hljs-string">&quot;string&quot;</span>
  18636. ],
  18637. <span class="hljs-attr">&quot;receivedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18638. <span class="hljs-attr">&quot;startAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18639. <span class="hljs-attr">&quot;dueAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18640. <span class="hljs-attr">&quot;endAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18641. <span class="hljs-attr">&quot;spentTime&quot;</span>: <span class="hljs-number">0</span>,
  18642. <span class="hljs-attr">&quot;isOvertime&quot;</span>: <span class="hljs-literal">true</span>,
  18643. <span class="hljs-attr">&quot;userId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18644. <span class="hljs-attr">&quot;sort&quot;</span>: <span class="hljs-number">0</span>,
  18645. <span class="hljs-attr">&quot;subtaskSort&quot;</span>: <span class="hljs-number">0</span>,
  18646. <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18647. <span class="hljs-attr">&quot;linkedId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18648. <span class="hljs-attr">&quot;vote&quot;</span>: {
  18649. <span class="hljs-attr">&quot;question&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18650. <span class="hljs-attr">&quot;positive&quot;</span>: [
  18651. <span class="hljs-string">&quot;string&quot;</span>
  18652. ],
  18653. <span class="hljs-attr">&quot;negative&quot;</span>: [
  18654. <span class="hljs-string">&quot;string&quot;</span>
  18655. ],
  18656. <span class="hljs-attr">&quot;end&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18657. <span class="hljs-attr">&quot;public&quot;</span>: <span class="hljs-literal">true</span>,
  18658. <span class="hljs-attr">&quot;allowNonBoardMembers&quot;</span>: <span class="hljs-literal">true</span>
  18659. },
  18660. <span class="hljs-attr">&quot;poker&quot;</span>: {
  18661. <span class="hljs-attr">&quot;question&quot;</span>: <span class="hljs-literal">true</span>,
  18662. <span class="hljs-attr">&quot;one&quot;</span>: [
  18663. <span class="hljs-string">&quot;string&quot;</span>
  18664. ],
  18665. <span class="hljs-attr">&quot;two&quot;</span>: [
  18666. <span class="hljs-string">&quot;string&quot;</span>
  18667. ],
  18668. <span class="hljs-attr">&quot;three&quot;</span>: [
  18669. <span class="hljs-string">&quot;string&quot;</span>
  18670. ],
  18671. <span class="hljs-attr">&quot;five&quot;</span>: [
  18672. <span class="hljs-string">&quot;string&quot;</span>
  18673. ],
  18674. <span class="hljs-attr">&quot;eight&quot;</span>: [
  18675. <span class="hljs-string">&quot;string&quot;</span>
  18676. ],
  18677. <span class="hljs-attr">&quot;thirteen&quot;</span>: [
  18678. <span class="hljs-string">&quot;string&quot;</span>
  18679. ],
  18680. <span class="hljs-attr">&quot;twenty&quot;</span>: [
  18681. <span class="hljs-string">&quot;string&quot;</span>
  18682. ],
  18683. <span class="hljs-attr">&quot;forty&quot;</span>: [
  18684. <span class="hljs-string">&quot;string&quot;</span>
  18685. ],
  18686. <span class="hljs-attr">&quot;oneHundred&quot;</span>: [
  18687. <span class="hljs-string">&quot;string&quot;</span>
  18688. ],
  18689. <span class="hljs-attr">&quot;unsure&quot;</span>: [
  18690. <span class="hljs-string">&quot;string&quot;</span>
  18691. ],
  18692. <span class="hljs-attr">&quot;end&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  18693. <span class="hljs-attr">&quot;allowNonBoardMembers&quot;</span>: <span class="hljs-literal">true</span>,
  18694. <span class="hljs-attr">&quot;estimation&quot;</span>: <span class="hljs-number">0</span>
  18695. },
  18696. <span class="hljs-attr">&quot;targetId_gantt&quot;</span>: [
  18697. <span class="hljs-string">&quot;string&quot;</span>
  18698. ],
  18699. <span class="hljs-attr">&quot;linkType_gantt&quot;</span>: [
  18700. <span class="hljs-number">0</span>
  18701. ],
  18702. <span class="hljs-attr">&quot;linkId_gantt&quot;</span>: [
  18703. <span class="hljs-string">&quot;string&quot;</span>
  18704. ],
  18705. <span class="hljs-attr">&quot;cardNumber&quot;</span>: <span class="hljs-number">0</span>
  18706. }
  18707. </code></pre>
  18708. <h3 id="properties-7">Properties</h3>
  18709. <table>
  18710. <thead>
  18711. <tr>
  18712. <th>Name</th>
  18713. <th>Type</th>
  18714. <th>Required</th>
  18715. <th>Restrictions</th>
  18716. <th>Description</th>
  18717. </tr>
  18718. </thead>
  18719. <tbody>
  18720. <tr>
  18721. <td>title</td>
  18722. <td>string¦null</td>
  18723. <td>false</td>
  18724. <td>none</td>
  18725. <td>the title of the card</td>
  18726. </tr>
  18727. <tr>
  18728. <td>archived</td>
  18729. <td>boolean</td>
  18730. <td>true</td>
  18731. <td>none</td>
  18732. <td>is the card archived</td>
  18733. </tr>
  18734. <tr>
  18735. <td>archivedAt</td>
  18736. <td>string¦null</td>
  18737. <td>false</td>
  18738. <td>none</td>
  18739. <td>latest archiving date</td>
  18740. </tr>
  18741. <tr>
  18742. <td>parentId</td>
  18743. <td>string¦null</td>
  18744. <td>false</td>
  18745. <td>none</td>
  18746. <td>ID of the parent card</td>
  18747. </tr>
  18748. <tr>
  18749. <td>listId</td>
  18750. <td>string¦null</td>
  18751. <td>false</td>
  18752. <td>none</td>
  18753. <td>List ID where the card is</td>
  18754. </tr>
  18755. <tr>
  18756. <td>swimlaneId</td>
  18757. <td>string</td>
  18758. <td>true</td>
  18759. <td>none</td>
  18760. <td>Swimlane ID where the card is</td>
  18761. </tr>
  18762. <tr>
  18763. <td>boardId</td>
  18764. <td>string¦null</td>
  18765. <td>false</td>
  18766. <td>none</td>
  18767. <td>Board ID of the card</td>
  18768. </tr>
  18769. <tr>
  18770. <td>coverId</td>
  18771. <td>string¦null</td>
  18772. <td>false</td>
  18773. <td>none</td>
  18774. <td>Cover ID of the card</td>
  18775. </tr>
  18776. <tr>
  18777. <td>color</td>
  18778. <td>string¦null</td>
  18779. <td>false</td>
  18780. <td>none</td>
  18781. <td>none</td>
  18782. </tr>
  18783. <tr>
  18784. <td>createdAt</td>
  18785. <td>string</td>
  18786. <td>true</td>
  18787. <td>none</td>
  18788. <td>creation date</td>
  18789. </tr>
  18790. <tr>
  18791. <td>modifiedAt</td>
  18792. <td>string</td>
  18793. <td>true</td>
  18794. <td>none</td>
  18795. <td>none</td>
  18796. </tr>
  18797. <tr>
  18798. <td>customFields</td>
  18799. <td>[<a href="#schemacardscustomfields">CardsCustomfields</a>]¦null</td>
  18800. <td>false</td>
  18801. <td>none</td>
  18802. <td>list of custom fields</td>
  18803. </tr>
  18804. <tr>
  18805. <td>dateLastActivity</td>
  18806. <td>string</td>
  18807. <td>true</td>
  18808. <td>none</td>
  18809. <td>Date of last activity</td>
  18810. </tr>
  18811. <tr>
  18812. <td>description</td>
  18813. <td>string¦null</td>
  18814. <td>false</td>
  18815. <td>none</td>
  18816. <td>description of the card</td>
  18817. </tr>
  18818. <tr>
  18819. <td>requestedBy</td>
  18820. <td>string¦null</td>
  18821. <td>false</td>
  18822. <td>none</td>
  18823. <td>who requested the card (ID of the user)</td>
  18824. </tr>
  18825. <tr>
  18826. <td>assignedBy</td>
  18827. <td>string¦null</td>
  18828. <td>false</td>
  18829. <td>none</td>
  18830. <td>who assigned the card (ID of the user)</td>
  18831. </tr>
  18832. <tr>
  18833. <td>labelIds</td>
  18834. <td>[string]¦null</td>
  18835. <td>false</td>
  18836. <td>none</td>
  18837. <td>list of labels ID the card has</td>
  18838. </tr>
  18839. <tr>
  18840. <td>members</td>
  18841. <td>[string]¦null</td>
  18842. <td>false</td>
  18843. <td>none</td>
  18844. <td>list of members (user IDs)</td>
  18845. </tr>
  18846. <tr>
  18847. <td>assignees</td>
  18848. <td>[string]¦null</td>
  18849. <td>false</td>
  18850. <td>none</td>
  18851. <td>who is assignee of the card (user ID),<br />maximum one ID of assignee in array.</td>
  18852. </tr>
  18853. <tr>
  18854. <td>receivedAt</td>
  18855. <td>string¦null</td>
  18856. <td>false</td>
  18857. <td>none</td>
  18858. <td>Date the card was received</td>
  18859. </tr>
  18860. <tr>
  18861. <td>startAt</td>
  18862. <td>string¦null</td>
  18863. <td>false</td>
  18864. <td>none</td>
  18865. <td>Date the card was started to be worked on</td>
  18866. </tr>
  18867. <tr>
  18868. <td>dueAt</td>
  18869. <td>string¦null</td>
  18870. <td>false</td>
  18871. <td>none</td>
  18872. <td>Date the card is due</td>
  18873. </tr>
  18874. <tr>
  18875. <td>endAt</td>
  18876. <td>string¦null</td>
  18877. <td>false</td>
  18878. <td>none</td>
  18879. <td>Date the card ended</td>
  18880. </tr>
  18881. <tr>
  18882. <td>spentTime</td>
  18883. <td>number¦null</td>
  18884. <td>false</td>
  18885. <td>none</td>
  18886. <td>How much time has been spent on this</td>
  18887. </tr>
  18888. <tr>
  18889. <td>isOvertime</td>
  18890. <td>boolean¦null</td>
  18891. <td>false</td>
  18892. <td>none</td>
  18893. <td>is the card over time?</td>
  18894. </tr>
  18895. <tr>
  18896. <td>userId</td>
  18897. <td>string</td>
  18898. <td>true</td>
  18899. <td>none</td>
  18900. <td>user ID of the author of the card</td>
  18901. </tr>
  18902. <tr>
  18903. <td>sort</td>
  18904. <td>number¦null</td>
  18905. <td>false</td>
  18906. <td>none</td>
  18907. <td>Sort value</td>
  18908. </tr>
  18909. <tr>
  18910. <td>subtaskSort</td>
  18911. <td>number¦null</td>
  18912. <td>false</td>
  18913. <td>none</td>
  18914. <td>subtask sort value</td>
  18915. </tr>
  18916. <tr>
  18917. <td>type</td>
  18918. <td>string</td>
  18919. <td>true</td>
  18920. <td>none</td>
  18921. <td>type of the card</td>
  18922. </tr>
  18923. <tr>
  18924. <td>linkedId</td>
  18925. <td>string¦null</td>
  18926. <td>false</td>
  18927. <td>none</td>
  18928. <td>ID of the linked card</td>
  18929. </tr>
  18930. <tr>
  18931. <td>vote</td>
  18932. <td><a href="#schemacardsvote">CardsVote</a></td>
  18933. <td>false</td>
  18934. <td>none</td>
  18935. <td>none</td>
  18936. </tr>
  18937. <tr>
  18938. <td>poker</td>
  18939. <td><a href="#schemacardspoker">CardsPoker</a></td>
  18940. <td>false</td>
  18941. <td>none</td>
  18942. <td>none</td>
  18943. </tr>
  18944. <tr>
  18945. <td>targetId_gantt</td>
  18946. <td>[string]¦null</td>
  18947. <td>false</td>
  18948. <td>none</td>
  18949. <td>ID of card which is the child link in gantt view</td>
  18950. </tr>
  18951. <tr>
  18952. <td>linkType_gantt</td>
  18953. <td>[number]¦null</td>
  18954. <td>false</td>
  18955. <td>none</td>
  18956. <td>ID of card which is the parent link in gantt view</td>
  18957. </tr>
  18958. <tr>
  18959. <td>linkId_gantt</td>
  18960. <td>[string]¦null</td>
  18961. <td>false</td>
  18962. <td>none</td>
  18963. <td>ID of card which is the parent link in gantt view</td>
  18964. </tr>
  18965. <tr>
  18966. <td>cardNumber</td>
  18967. <td>number¦null</td>
  18968. <td>false</td>
  18969. <td>none</td>
  18970. <td>A boardwise sequentially increasing number that is assigned<br />to every newly created card</td>
  18971. </tr>
  18972. </tbody>
  18973. </table>
  18974. <h4 id="enumerated-values-3">Enumerated Values</h4>
  18975. <table>
  18976. <thead>
  18977. <tr>
  18978. <th>Property</th>
  18979. <th>Value</th>
  18980. </tr>
  18981. </thead>
  18982. <tbody>
  18983. <tr>
  18984. <td>color</td>
  18985. <td>white</td>
  18986. </tr>
  18987. <tr>
  18988. <td>color</td>
  18989. <td>green</td>
  18990. </tr>
  18991. <tr>
  18992. <td>color</td>
  18993. <td>yellow</td>
  18994. </tr>
  18995. <tr>
  18996. <td>color</td>
  18997. <td>orange</td>
  18998. </tr>
  18999. <tr>
  19000. <td>color</td>
  19001. <td>red</td>
  19002. </tr>
  19003. <tr>
  19004. <td>color</td>
  19005. <td>purple</td>
  19006. </tr>
  19007. <tr>
  19008. <td>color</td>
  19009. <td>blue</td>
  19010. </tr>
  19011. <tr>
  19012. <td>color</td>
  19013. <td>sky</td>
  19014. </tr>
  19015. <tr>
  19016. <td>color</td>
  19017. <td>lime</td>
  19018. </tr>
  19019. <tr>
  19020. <td>color</td>
  19021. <td>pink</td>
  19022. </tr>
  19023. <tr>
  19024. <td>color</td>
  19025. <td>black</td>
  19026. </tr>
  19027. <tr>
  19028. <td>color</td>
  19029. <td>silver</td>
  19030. </tr>
  19031. <tr>
  19032. <td>color</td>
  19033. <td>peachpuff</td>
  19034. </tr>
  19035. <tr>
  19036. <td>color</td>
  19037. <td>crimson</td>
  19038. </tr>
  19039. <tr>
  19040. <td>color</td>
  19041. <td>plum</td>
  19042. </tr>
  19043. <tr>
  19044. <td>color</td>
  19045. <td>darkgreen</td>
  19046. </tr>
  19047. <tr>
  19048. <td>color</td>
  19049. <td>slateblue</td>
  19050. </tr>
  19051. <tr>
  19052. <td>color</td>
  19053. <td>magenta</td>
  19054. </tr>
  19055. <tr>
  19056. <td>color</td>
  19057. <td>gold</td>
  19058. </tr>
  19059. <tr>
  19060. <td>color</td>
  19061. <td>navy</td>
  19062. </tr>
  19063. <tr>
  19064. <td>color</td>
  19065. <td>gray</td>
  19066. </tr>
  19067. <tr>
  19068. <td>color</td>
  19069. <td>saddlebrown</td>
  19070. </tr>
  19071. <tr>
  19072. <td>color</td>
  19073. <td>paleturquoise</td>
  19074. </tr>
  19075. <tr>
  19076. <td>color</td>
  19077. <td>mistyrose</td>
  19078. </tr>
  19079. <tr>
  19080. <td>color</td>
  19081. <td>indigo</td>
  19082. </tr>
  19083. </tbody>
  19084. </table>
  19085. <h2 id="tocs_cardsvote">CardsVote</h2>
  19086. <p><a id="schemacardsvote"></a>
  19087. <a id="schema_CardsVote"></a>
  19088. <a id="tocScardsvote"></a>
  19089. <a id="tocscardsvote"></a></p>
  19090. <pre class="highlight tab tab-json"><code>{
  19091. <span class="hljs-attr">&quot;question&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19092. <span class="hljs-attr">&quot;positive&quot;</span>: [
  19093. <span class="hljs-string">&quot;string&quot;</span>
  19094. ],
  19095. <span class="hljs-attr">&quot;negative&quot;</span>: [
  19096. <span class="hljs-string">&quot;string&quot;</span>
  19097. ],
  19098. <span class="hljs-attr">&quot;end&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19099. <span class="hljs-attr">&quot;public&quot;</span>: <span class="hljs-literal">true</span>,
  19100. <span class="hljs-attr">&quot;allowNonBoardMembers&quot;</span>: <span class="hljs-literal">true</span>
  19101. }
  19102. </code></pre>
  19103. <h3 id="properties-8">Properties</h3>
  19104. <table>
  19105. <thead>
  19106. <tr>
  19107. <th>Name</th>
  19108. <th>Type</th>
  19109. <th>Required</th>
  19110. <th>Restrictions</th>
  19111. <th>Description</th>
  19112. </tr>
  19113. </thead>
  19114. <tbody>
  19115. <tr>
  19116. <td>question</td>
  19117. <td>string</td>
  19118. <td>true</td>
  19119. <td>none</td>
  19120. <td>none</td>
  19121. </tr>
  19122. <tr>
  19123. <td>positive</td>
  19124. <td>[string]</td>
  19125. <td>false</td>
  19126. <td>none</td>
  19127. <td>list of members (user IDs)</td>
  19128. </tr>
  19129. <tr>
  19130. <td>negative</td>
  19131. <td>[string]</td>
  19132. <td>false</td>
  19133. <td>none</td>
  19134. <td>list of members (user IDs)</td>
  19135. </tr>
  19136. <tr>
  19137. <td>end</td>
  19138. <td>string</td>
  19139. <td>false</td>
  19140. <td>none</td>
  19141. <td>none</td>
  19142. </tr>
  19143. <tr>
  19144. <td>public</td>
  19145. <td>boolean</td>
  19146. <td>true</td>
  19147. <td>none</td>
  19148. <td>none</td>
  19149. </tr>
  19150. <tr>
  19151. <td>allowNonBoardMembers</td>
  19152. <td>boolean</td>
  19153. <td>true</td>
  19154. <td>none</td>
  19155. <td>none</td>
  19156. </tr>
  19157. </tbody>
  19158. </table>
  19159. <h2 id="tocs_cardspoker">CardsPoker</h2>
  19160. <p><a id="schemacardspoker"></a>
  19161. <a id="schema_CardsPoker"></a>
  19162. <a id="tocScardspoker"></a>
  19163. <a id="tocscardspoker"></a></p>
  19164. <pre class="highlight tab tab-json"><code>{
  19165. <span class="hljs-attr">&quot;question&quot;</span>: <span class="hljs-literal">true</span>,
  19166. <span class="hljs-attr">&quot;one&quot;</span>: [
  19167. <span class="hljs-string">&quot;string&quot;</span>
  19168. ],
  19169. <span class="hljs-attr">&quot;two&quot;</span>: [
  19170. <span class="hljs-string">&quot;string&quot;</span>
  19171. ],
  19172. <span class="hljs-attr">&quot;three&quot;</span>: [
  19173. <span class="hljs-string">&quot;string&quot;</span>
  19174. ],
  19175. <span class="hljs-attr">&quot;five&quot;</span>: [
  19176. <span class="hljs-string">&quot;string&quot;</span>
  19177. ],
  19178. <span class="hljs-attr">&quot;eight&quot;</span>: [
  19179. <span class="hljs-string">&quot;string&quot;</span>
  19180. ],
  19181. <span class="hljs-attr">&quot;thirteen&quot;</span>: [
  19182. <span class="hljs-string">&quot;string&quot;</span>
  19183. ],
  19184. <span class="hljs-attr">&quot;twenty&quot;</span>: [
  19185. <span class="hljs-string">&quot;string&quot;</span>
  19186. ],
  19187. <span class="hljs-attr">&quot;forty&quot;</span>: [
  19188. <span class="hljs-string">&quot;string&quot;</span>
  19189. ],
  19190. <span class="hljs-attr">&quot;oneHundred&quot;</span>: [
  19191. <span class="hljs-string">&quot;string&quot;</span>
  19192. ],
  19193. <span class="hljs-attr">&quot;unsure&quot;</span>: [
  19194. <span class="hljs-string">&quot;string&quot;</span>
  19195. ],
  19196. <span class="hljs-attr">&quot;end&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19197. <span class="hljs-attr">&quot;allowNonBoardMembers&quot;</span>: <span class="hljs-literal">true</span>,
  19198. <span class="hljs-attr">&quot;estimation&quot;</span>: <span class="hljs-number">0</span>
  19199. }
  19200. </code></pre>
  19201. <h3 id="properties-9">Properties</h3>
  19202. <table>
  19203. <thead>
  19204. <tr>
  19205. <th>Name</th>
  19206. <th>Type</th>
  19207. <th>Required</th>
  19208. <th>Restrictions</th>
  19209. <th>Description</th>
  19210. </tr>
  19211. </thead>
  19212. <tbody>
  19213. <tr>
  19214. <td>question</td>
  19215. <td>boolean</td>
  19216. <td>true</td>
  19217. <td>none</td>
  19218. <td>none</td>
  19219. </tr>
  19220. <tr>
  19221. <td>one</td>
  19222. <td>[string]</td>
  19223. <td>false</td>
  19224. <td>none</td>
  19225. <td>poker card one</td>
  19226. </tr>
  19227. <tr>
  19228. <td>two</td>
  19229. <td>[string]</td>
  19230. <td>false</td>
  19231. <td>none</td>
  19232. <td>poker card two</td>
  19233. </tr>
  19234. <tr>
  19235. <td>three</td>
  19236. <td>[string]</td>
  19237. <td>false</td>
  19238. <td>none</td>
  19239. <td>poker card three</td>
  19240. </tr>
  19241. <tr>
  19242. <td>five</td>
  19243. <td>[string]</td>
  19244. <td>false</td>
  19245. <td>none</td>
  19246. <td>poker card five</td>
  19247. </tr>
  19248. <tr>
  19249. <td>eight</td>
  19250. <td>[string]</td>
  19251. <td>false</td>
  19252. <td>none</td>
  19253. <td>poker card eight</td>
  19254. </tr>
  19255. <tr>
  19256. <td>thirteen</td>
  19257. <td>[string]</td>
  19258. <td>false</td>
  19259. <td>none</td>
  19260. <td>poker card thirteen</td>
  19261. </tr>
  19262. <tr>
  19263. <td>twenty</td>
  19264. <td>[string]</td>
  19265. <td>false</td>
  19266. <td>none</td>
  19267. <td>poker card twenty</td>
  19268. </tr>
  19269. <tr>
  19270. <td>forty</td>
  19271. <td>[string]</td>
  19272. <td>false</td>
  19273. <td>none</td>
  19274. <td>poker card forty</td>
  19275. </tr>
  19276. <tr>
  19277. <td>oneHundred</td>
  19278. <td>[string]</td>
  19279. <td>false</td>
  19280. <td>none</td>
  19281. <td>poker card oneHundred</td>
  19282. </tr>
  19283. <tr>
  19284. <td>unsure</td>
  19285. <td>[string]</td>
  19286. <td>false</td>
  19287. <td>none</td>
  19288. <td>poker card unsure</td>
  19289. </tr>
  19290. <tr>
  19291. <td>end</td>
  19292. <td>string</td>
  19293. <td>false</td>
  19294. <td>none</td>
  19295. <td>none</td>
  19296. </tr>
  19297. <tr>
  19298. <td>allowNonBoardMembers</td>
  19299. <td>boolean</td>
  19300. <td>true</td>
  19301. <td>none</td>
  19302. <td>none</td>
  19303. </tr>
  19304. <tr>
  19305. <td>estimation</td>
  19306. <td>number</td>
  19307. <td>false</td>
  19308. <td>none</td>
  19309. <td>poker estimation value</td>
  19310. </tr>
  19311. </tbody>
  19312. </table>
  19313. <h2 id="tocs_cardscustomfields">CardsCustomfields</h2>
  19314. <p><a id="schemacardscustomfields"></a>
  19315. <a id="schema_CardsCustomfields"></a>
  19316. <a id="tocScardscustomfields"></a>
  19317. <a id="tocscardscustomfields"></a></p>
  19318. <pre class="highlight tab tab-json"><code>{}
  19319. </code></pre>
  19320. <h3 id="properties-10">Properties</h3>
  19321. <p><em>None</em></p>
  19322. <h2 id="tocs_checklistitems">ChecklistItems</h2>
  19323. <p><a id="schemachecklistitems"></a>
  19324. <a id="schema_ChecklistItems"></a>
  19325. <a id="tocSchecklistitems"></a>
  19326. <a id="tocschecklistitems"></a></p>
  19327. <pre class="highlight tab tab-json"><code>{
  19328. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19329. <span class="hljs-attr">&quot;sort&quot;</span>: <span class="hljs-number">0</span>,
  19330. <span class="hljs-attr">&quot;isFinished&quot;</span>: <span class="hljs-literal">true</span>,
  19331. <span class="hljs-attr">&quot;checklistId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19332. <span class="hljs-attr">&quot;cardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19333. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19334. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  19335. }
  19336. </code></pre>
  19337. <p>An item in a checklist</p>
  19338. <h3 id="properties-11">Properties</h3>
  19339. <table>
  19340. <thead>
  19341. <tr>
  19342. <th>Name</th>
  19343. <th>Type</th>
  19344. <th>Required</th>
  19345. <th>Restrictions</th>
  19346. <th>Description</th>
  19347. </tr>
  19348. </thead>
  19349. <tbody>
  19350. <tr>
  19351. <td>title</td>
  19352. <td>string</td>
  19353. <td>true</td>
  19354. <td>none</td>
  19355. <td>the text of the item</td>
  19356. </tr>
  19357. <tr>
  19358. <td>sort</td>
  19359. <td>number</td>
  19360. <td>true</td>
  19361. <td>none</td>
  19362. <td>the sorting field of the item</td>
  19363. </tr>
  19364. <tr>
  19365. <td>isFinished</td>
  19366. <td>boolean</td>
  19367. <td>true</td>
  19368. <td>none</td>
  19369. <td>Is the item checked?</td>
  19370. </tr>
  19371. <tr>
  19372. <td>checklistId</td>
  19373. <td>string</td>
  19374. <td>true</td>
  19375. <td>none</td>
  19376. <td>the checklist ID the item is attached to</td>
  19377. </tr>
  19378. <tr>
  19379. <td>cardId</td>
  19380. <td>string</td>
  19381. <td>true</td>
  19382. <td>none</td>
  19383. <td>the card ID the item is attached to</td>
  19384. </tr>
  19385. <tr>
  19386. <td>createdAt</td>
  19387. <td>string¦null</td>
  19388. <td>false</td>
  19389. <td>none</td>
  19390. <td>none</td>
  19391. </tr>
  19392. <tr>
  19393. <td>modifiedAt</td>
  19394. <td>string</td>
  19395. <td>true</td>
  19396. <td>none</td>
  19397. <td>none</td>
  19398. </tr>
  19399. </tbody>
  19400. </table>
  19401. <h2 id="tocs_checklists">Checklists</h2>
  19402. <p><a id="schemachecklists"></a>
  19403. <a id="schema_Checklists"></a>
  19404. <a id="tocSchecklists"></a>
  19405. <a id="tocschecklists"></a></p>
  19406. <pre class="highlight tab tab-json"><code>{
  19407. <span class="hljs-attr">&quot;cardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19408. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19409. <span class="hljs-attr">&quot;finishedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19410. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19411. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19412. <span class="hljs-attr">&quot;sort&quot;</span>: <span class="hljs-number">0</span>
  19413. }
  19414. </code></pre>
  19415. <p>A Checklist</p>
  19416. <h3 id="properties-12">Properties</h3>
  19417. <table>
  19418. <thead>
  19419. <tr>
  19420. <th>Name</th>
  19421. <th>Type</th>
  19422. <th>Required</th>
  19423. <th>Restrictions</th>
  19424. <th>Description</th>
  19425. </tr>
  19426. </thead>
  19427. <tbody>
  19428. <tr>
  19429. <td>cardId</td>
  19430. <td>string</td>
  19431. <td>true</td>
  19432. <td>none</td>
  19433. <td>The ID of the card the checklist is in</td>
  19434. </tr>
  19435. <tr>
  19436. <td>title</td>
  19437. <td>string</td>
  19438. <td>true</td>
  19439. <td>none</td>
  19440. <td>the title of the checklist</td>
  19441. </tr>
  19442. <tr>
  19443. <td>finishedAt</td>
  19444. <td>string¦null</td>
  19445. <td>false</td>
  19446. <td>none</td>
  19447. <td>When was the checklist finished</td>
  19448. </tr>
  19449. <tr>
  19450. <td>createdAt</td>
  19451. <td>string</td>
  19452. <td>true</td>
  19453. <td>none</td>
  19454. <td>Creation date of the checklist</td>
  19455. </tr>
  19456. <tr>
  19457. <td>modifiedAt</td>
  19458. <td>string</td>
  19459. <td>true</td>
  19460. <td>none</td>
  19461. <td>none</td>
  19462. </tr>
  19463. <tr>
  19464. <td>sort</td>
  19465. <td>number</td>
  19466. <td>true</td>
  19467. <td>none</td>
  19468. <td>sorting value of the checklist</td>
  19469. </tr>
  19470. </tbody>
  19471. </table>
  19472. <h2 id="tocs_customfields">CustomFields</h2>
  19473. <p><a id="schemacustomfields"></a>
  19474. <a id="schema_CustomFields"></a>
  19475. <a id="tocScustomfields"></a>
  19476. <a id="tocscustomfields"></a></p>
  19477. <pre class="highlight tab tab-json"><code>{
  19478. <span class="hljs-attr">&quot;boardIds&quot;</span>: [
  19479. <span class="hljs-string">&quot;string&quot;</span>
  19480. ],
  19481. <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19482. <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;text&quot;</span>,
  19483. <span class="hljs-attr">&quot;settings&quot;</span>: {
  19484. <span class="hljs-attr">&quot;currencyCode&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19485. <span class="hljs-attr">&quot;dropdownItems&quot;</span>: [
  19486. {}
  19487. ],
  19488. <span class="hljs-attr">&quot;stringtemplateFormat&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19489. <span class="hljs-attr">&quot;stringtemplateSeparator&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  19490. },
  19491. <span class="hljs-attr">&quot;showOnCard&quot;</span>: <span class="hljs-literal">true</span>,
  19492. <span class="hljs-attr">&quot;automaticallyOnCard&quot;</span>: <span class="hljs-literal">true</span>,
  19493. <span class="hljs-attr">&quot;alwaysOnCard&quot;</span>: <span class="hljs-literal">true</span>,
  19494. <span class="hljs-attr">&quot;showLabelOnMiniCard&quot;</span>: <span class="hljs-literal">true</span>,
  19495. <span class="hljs-attr">&quot;showSumAtTopOfList&quot;</span>: <span class="hljs-literal">true</span>,
  19496. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19497. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  19498. }
  19499. </code></pre>
  19500. <p>A custom field on a card in the board</p>
  19501. <h3 id="properties-13">Properties</h3>
  19502. <table>
  19503. <thead>
  19504. <tr>
  19505. <th>Name</th>
  19506. <th>Type</th>
  19507. <th>Required</th>
  19508. <th>Restrictions</th>
  19509. <th>Description</th>
  19510. </tr>
  19511. </thead>
  19512. <tbody>
  19513. <tr>
  19514. <td>boardIds</td>
  19515. <td>[string]</td>
  19516. <td>true</td>
  19517. <td>none</td>
  19518. <td>the ID of the board</td>
  19519. </tr>
  19520. <tr>
  19521. <td>name</td>
  19522. <td>string</td>
  19523. <td>true</td>
  19524. <td>none</td>
  19525. <td>name of the custom field</td>
  19526. </tr>
  19527. <tr>
  19528. <td>type</td>
  19529. <td>string</td>
  19530. <td>true</td>
  19531. <td>none</td>
  19532. <td>type of the custom field</td>
  19533. </tr>
  19534. <tr>
  19535. <td>settings</td>
  19536. <td><a href="#schemacustomfieldssettings">CustomFieldsSettings</a></td>
  19537. <td>true</td>
  19538. <td>none</td>
  19539. <td>none</td>
  19540. </tr>
  19541. <tr>
  19542. <td>showOnCard</td>
  19543. <td>boolean</td>
  19544. <td>true</td>
  19545. <td>none</td>
  19546. <td>should we show on the cards this custom field</td>
  19547. </tr>
  19548. <tr>
  19549. <td>automaticallyOnCard</td>
  19550. <td>boolean</td>
  19551. <td>true</td>
  19552. <td>none</td>
  19553. <td>should the custom fields automatically be added on cards?</td>
  19554. </tr>
  19555. <tr>
  19556. <td>alwaysOnCard</td>
  19557. <td>boolean</td>
  19558. <td>true</td>
  19559. <td>none</td>
  19560. <td>should the custom field be automatically added to all cards?</td>
  19561. </tr>
  19562. <tr>
  19563. <td>showLabelOnMiniCard</td>
  19564. <td>boolean</td>
  19565. <td>true</td>
  19566. <td>none</td>
  19567. <td>should the label of the custom field be shown on minicards?</td>
  19568. </tr>
  19569. <tr>
  19570. <td>showSumAtTopOfList</td>
  19571. <td>boolean</td>
  19572. <td>true</td>
  19573. <td>none</td>
  19574. <td>should the sum of the custom fields be shown at top of list?</td>
  19575. </tr>
  19576. <tr>
  19577. <td>createdAt</td>
  19578. <td>string¦null</td>
  19579. <td>false</td>
  19580. <td>none</td>
  19581. <td>none</td>
  19582. </tr>
  19583. <tr>
  19584. <td>modifiedAt</td>
  19585. <td>string</td>
  19586. <td>true</td>
  19587. <td>none</td>
  19588. <td>none</td>
  19589. </tr>
  19590. </tbody>
  19591. </table>
  19592. <h4 id="enumerated-values-4">Enumerated Values</h4>
  19593. <table>
  19594. <thead>
  19595. <tr>
  19596. <th>Property</th>
  19597. <th>Value</th>
  19598. </tr>
  19599. </thead>
  19600. <tbody>
  19601. <tr>
  19602. <td>type</td>
  19603. <td>text</td>
  19604. </tr>
  19605. <tr>
  19606. <td>type</td>
  19607. <td>number</td>
  19608. </tr>
  19609. <tr>
  19610. <td>type</td>
  19611. <td>date</td>
  19612. </tr>
  19613. <tr>
  19614. <td>type</td>
  19615. <td>dropdown</td>
  19616. </tr>
  19617. <tr>
  19618. <td>type</td>
  19619. <td>checkbox</td>
  19620. </tr>
  19621. <tr>
  19622. <td>type</td>
  19623. <td>currency</td>
  19624. </tr>
  19625. <tr>
  19626. <td>type</td>
  19627. <td>stringtemplate</td>
  19628. </tr>
  19629. </tbody>
  19630. </table>
  19631. <h2 id="tocs_customfieldssettings">CustomFieldsSettings</h2>
  19632. <p><a id="schemacustomfieldssettings"></a>
  19633. <a id="schema_CustomFieldsSettings"></a>
  19634. <a id="tocScustomfieldssettings"></a>
  19635. <a id="tocscustomfieldssettings"></a></p>
  19636. <pre class="highlight tab tab-json"><code>{
  19637. <span class="hljs-attr">&quot;currencyCode&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19638. <span class="hljs-attr">&quot;dropdownItems&quot;</span>: [
  19639. {}
  19640. ],
  19641. <span class="hljs-attr">&quot;stringtemplateFormat&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19642. <span class="hljs-attr">&quot;stringtemplateSeparator&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  19643. }
  19644. </code></pre>
  19645. <h3 id="properties-14">Properties</h3>
  19646. <table>
  19647. <thead>
  19648. <tr>
  19649. <th>Name</th>
  19650. <th>Type</th>
  19651. <th>Required</th>
  19652. <th>Restrictions</th>
  19653. <th>Description</th>
  19654. </tr>
  19655. </thead>
  19656. <tbody>
  19657. <tr>
  19658. <td>currencyCode</td>
  19659. <td>string</td>
  19660. <td>false</td>
  19661. <td>none</td>
  19662. <td>none</td>
  19663. </tr>
  19664. <tr>
  19665. <td>dropdownItems</td>
  19666. <td>[<a href="#schemacustomfieldssettingsdropdownitems">CustomFieldsSettingsDropdownitems</a>]</td>
  19667. <td>false</td>
  19668. <td>none</td>
  19669. <td>list of drop down items objects</td>
  19670. </tr>
  19671. <tr>
  19672. <td>stringtemplateFormat</td>
  19673. <td>string</td>
  19674. <td>false</td>
  19675. <td>none</td>
  19676. <td>none</td>
  19677. </tr>
  19678. <tr>
  19679. <td>stringtemplateSeparator</td>
  19680. <td>string</td>
  19681. <td>false</td>
  19682. <td>none</td>
  19683. <td>none</td>
  19684. </tr>
  19685. </tbody>
  19686. </table>
  19687. <h2 id="tocs_customfieldssettingsdropdownitems">CustomFieldsSettingsDropdownitems</h2>
  19688. <p><a id="schemacustomfieldssettingsdropdownitems"></a>
  19689. <a id="schema_CustomFieldsSettingsDropdownitems"></a>
  19690. <a id="tocScustomfieldssettingsdropdownitems"></a>
  19691. <a id="tocscustomfieldssettingsdropdownitems"></a></p>
  19692. <pre class="highlight tab tab-json"><code>{}
  19693. </code></pre>
  19694. <h3 id="properties-15">Properties</h3>
  19695. <p><em>None</em></p>
  19696. <h2 id="tocs_integrations">Integrations</h2>
  19697. <p><a id="schemaintegrations"></a>
  19698. <a id="schema_Integrations"></a>
  19699. <a id="tocSintegrations"></a>
  19700. <a id="tocsintegrations"></a></p>
  19701. <pre class="highlight tab tab-json"><code>{
  19702. <span class="hljs-attr">&quot;enabled&quot;</span>: <span class="hljs-literal">true</span>,
  19703. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19704. <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19705. <span class="hljs-attr">&quot;activities&quot;</span>: [
  19706. <span class="hljs-string">&quot;string&quot;</span>
  19707. ],
  19708. <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19709. <span class="hljs-attr">&quot;token&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19710. <span class="hljs-attr">&quot;boardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19711. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19712. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19713. <span class="hljs-attr">&quot;userId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  19714. }
  19715. </code></pre>
  19716. <p>Integration with third-party applications</p>
  19717. <h3 id="properties-16">Properties</h3>
  19718. <table>
  19719. <thead>
  19720. <tr>
  19721. <th>Name</th>
  19722. <th>Type</th>
  19723. <th>Required</th>
  19724. <th>Restrictions</th>
  19725. <th>Description</th>
  19726. </tr>
  19727. </thead>
  19728. <tbody>
  19729. <tr>
  19730. <td>enabled</td>
  19731. <td>boolean</td>
  19732. <td>true</td>
  19733. <td>none</td>
  19734. <td>is the integration enabled?</td>
  19735. </tr>
  19736. <tr>
  19737. <td>title</td>
  19738. <td>string¦null</td>
  19739. <td>false</td>
  19740. <td>none</td>
  19741. <td>name of the integration</td>
  19742. </tr>
  19743. <tr>
  19744. <td>type</td>
  19745. <td>string</td>
  19746. <td>true</td>
  19747. <td>none</td>
  19748. <td>type of the integratation (Default to 'outgoing-webhooks')</td>
  19749. </tr>
  19750. <tr>
  19751. <td>activities</td>
  19752. <td>[string]</td>
  19753. <td>true</td>
  19754. <td>none</td>
  19755. <td>activities the integration gets triggered (list)</td>
  19756. </tr>
  19757. <tr>
  19758. <td>url</td>
  19759. <td>string</td>
  19760. <td>true</td>
  19761. <td>none</td>
  19762. <td>none</td>
  19763. </tr>
  19764. <tr>
  19765. <td>token</td>
  19766. <td>string¦null</td>
  19767. <td>false</td>
  19768. <td>none</td>
  19769. <td>token of the integration</td>
  19770. </tr>
  19771. <tr>
  19772. <td>boardId</td>
  19773. <td>string</td>
  19774. <td>true</td>
  19775. <td>none</td>
  19776. <td>Board ID of the integration</td>
  19777. </tr>
  19778. <tr>
  19779. <td>createdAt</td>
  19780. <td>string</td>
  19781. <td>true</td>
  19782. <td>none</td>
  19783. <td>Creation date of the integration</td>
  19784. </tr>
  19785. <tr>
  19786. <td>modifiedAt</td>
  19787. <td>string</td>
  19788. <td>true</td>
  19789. <td>none</td>
  19790. <td>none</td>
  19791. </tr>
  19792. <tr>
  19793. <td>userId</td>
  19794. <td>string</td>
  19795. <td>true</td>
  19796. <td>none</td>
  19797. <td>user ID who created the interation</td>
  19798. </tr>
  19799. </tbody>
  19800. </table>
  19801. <h2 id="tocs_lists">Lists</h2>
  19802. <p><a id="schemalists"></a>
  19803. <a id="schema_Lists"></a>
  19804. <a id="tocSlists"></a>
  19805. <a id="tocslists"></a></p>
  19806. <pre class="highlight tab tab-json"><code>{
  19807. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19808. <span class="hljs-attr">&quot;starred&quot;</span>: <span class="hljs-literal">true</span>,
  19809. <span class="hljs-attr">&quot;archived&quot;</span>: <span class="hljs-literal">true</span>,
  19810. <span class="hljs-attr">&quot;archivedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19811. <span class="hljs-attr">&quot;boardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19812. <span class="hljs-attr">&quot;swimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19813. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19814. <span class="hljs-attr">&quot;sort&quot;</span>: <span class="hljs-number">0</span>,
  19815. <span class="hljs-attr">&quot;width&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19816. <span class="hljs-attr">&quot;height&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19817. <span class="hljs-attr">&quot;updatedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19818. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  19819. <span class="hljs-attr">&quot;wipLimit&quot;</span>: {
  19820. <span class="hljs-attr">&quot;value&quot;</span>: <span class="hljs-number">0</span>,
  19821. <span class="hljs-attr">&quot;enabled&quot;</span>: <span class="hljs-literal">true</span>,
  19822. <span class="hljs-attr">&quot;soft&quot;</span>: <span class="hljs-literal">true</span>
  19823. },
  19824. <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;white&quot;</span>,
  19825. <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  19826. }
  19827. </code></pre>
  19828. <p>A list (column) in the Wekan board.</p>
  19829. <h3 id="properties-17">Properties</h3>
  19830. <table>
  19831. <thead>
  19832. <tr>
  19833. <th>Name</th>
  19834. <th>Type</th>
  19835. <th>Required</th>
  19836. <th>Restrictions</th>
  19837. <th>Description</th>
  19838. </tr>
  19839. </thead>
  19840. <tbody>
  19841. <tr>
  19842. <td>title</td>
  19843. <td>string</td>
  19844. <td>true</td>
  19845. <td>none</td>
  19846. <td>the title of the list</td>
  19847. </tr>
  19848. <tr>
  19849. <td>starred</td>
  19850. <td>boolean¦null</td>
  19851. <td>false</td>
  19852. <td>none</td>
  19853. <td>if a list is stared<br />then we put it on the top</td>
  19854. </tr>
  19855. <tr>
  19856. <td>archived</td>
  19857. <td>boolean</td>
  19858. <td>true</td>
  19859. <td>none</td>
  19860. <td>is the list archived</td>
  19861. </tr>
  19862. <tr>
  19863. <td>archivedAt</td>
  19864. <td>string¦null</td>
  19865. <td>false</td>
  19866. <td>none</td>
  19867. <td>latest archiving date</td>
  19868. </tr>
  19869. <tr>
  19870. <td>boardId</td>
  19871. <td>string</td>
  19872. <td>true</td>
  19873. <td>none</td>
  19874. <td>the board associated to this list</td>
  19875. </tr>
  19876. <tr>
  19877. <td>swimlaneId</td>
  19878. <td>string</td>
  19879. <td>true</td>
  19880. <td>none</td>
  19881. <td>the swimlane associated to this list. Used for templates</td>
  19882. </tr>
  19883. <tr>
  19884. <td>createdAt</td>
  19885. <td>string</td>
  19886. <td>true</td>
  19887. <td>none</td>
  19888. <td>creation date</td>
  19889. </tr>
  19890. <tr>
  19891. <td>sort</td>
  19892. <td>number¦null</td>
  19893. <td>false</td>
  19894. <td>none</td>
  19895. <td>is the list sorted</td>
  19896. </tr>
  19897. <tr>
  19898. <td>width</td>
  19899. <td>string¦null</td>
  19900. <td>false</td>
  19901. <td>none</td>
  19902. <td>list width, default 270px</td>
  19903. </tr>
  19904. <tr>
  19905. <td>height</td>
  19906. <td>string¦null</td>
  19907. <td>false</td>
  19908. <td>none</td>
  19909. <td>list height</td>
  19910. </tr>
  19911. <tr>
  19912. <td>updatedAt</td>
  19913. <td>string¦null</td>
  19914. <td>false</td>
  19915. <td>none</td>
  19916. <td>last update of the list</td>
  19917. </tr>
  19918. <tr>
  19919. <td>modifiedAt</td>
  19920. <td>string</td>
  19921. <td>true</td>
  19922. <td>none</td>
  19923. <td>none</td>
  19924. </tr>
  19925. <tr>
  19926. <td>wipLimit</td>
  19927. <td><a href="#schemalistswiplimit">ListsWiplimit</a></td>
  19928. <td>false</td>
  19929. <td>none</td>
  19930. <td>none</td>
  19931. </tr>
  19932. <tr>
  19933. <td>color</td>
  19934. <td>string¦null</td>
  19935. <td>false</td>
  19936. <td>none</td>
  19937. <td>the color of the list</td>
  19938. </tr>
  19939. <tr>
  19940. <td>type</td>
  19941. <td>string</td>
  19942. <td>true</td>
  19943. <td>none</td>
  19944. <td>The type of list</td>
  19945. </tr>
  19946. </tbody>
  19947. </table>
  19948. <h4 id="enumerated-values-5">Enumerated Values</h4>
  19949. <table>
  19950. <thead>
  19951. <tr>
  19952. <th>Property</th>
  19953. <th>Value</th>
  19954. </tr>
  19955. </thead>
  19956. <tbody>
  19957. <tr>
  19958. <td>color</td>
  19959. <td>white</td>
  19960. </tr>
  19961. <tr>
  19962. <td>color</td>
  19963. <td>green</td>
  19964. </tr>
  19965. <tr>
  19966. <td>color</td>
  19967. <td>yellow</td>
  19968. </tr>
  19969. <tr>
  19970. <td>color</td>
  19971. <td>orange</td>
  19972. </tr>
  19973. <tr>
  19974. <td>color</td>
  19975. <td>red</td>
  19976. </tr>
  19977. <tr>
  19978. <td>color</td>
  19979. <td>purple</td>
  19980. </tr>
  19981. <tr>
  19982. <td>color</td>
  19983. <td>blue</td>
  19984. </tr>
  19985. <tr>
  19986. <td>color</td>
  19987. <td>sky</td>
  19988. </tr>
  19989. <tr>
  19990. <td>color</td>
  19991. <td>lime</td>
  19992. </tr>
  19993. <tr>
  19994. <td>color</td>
  19995. <td>pink</td>
  19996. </tr>
  19997. <tr>
  19998. <td>color</td>
  19999. <td>black</td>
  20000. </tr>
  20001. <tr>
  20002. <td>color</td>
  20003. <td>silver</td>
  20004. </tr>
  20005. <tr>
  20006. <td>color</td>
  20007. <td>peachpuff</td>
  20008. </tr>
  20009. <tr>
  20010. <td>color</td>
  20011. <td>crimson</td>
  20012. </tr>
  20013. <tr>
  20014. <td>color</td>
  20015. <td>plum</td>
  20016. </tr>
  20017. <tr>
  20018. <td>color</td>
  20019. <td>darkgreen</td>
  20020. </tr>
  20021. <tr>
  20022. <td>color</td>
  20023. <td>slateblue</td>
  20024. </tr>
  20025. <tr>
  20026. <td>color</td>
  20027. <td>magenta</td>
  20028. </tr>
  20029. <tr>
  20030. <td>color</td>
  20031. <td>gold</td>
  20032. </tr>
  20033. <tr>
  20034. <td>color</td>
  20035. <td>navy</td>
  20036. </tr>
  20037. <tr>
  20038. <td>color</td>
  20039. <td>gray</td>
  20040. </tr>
  20041. <tr>
  20042. <td>color</td>
  20043. <td>saddlebrown</td>
  20044. </tr>
  20045. <tr>
  20046. <td>color</td>
  20047. <td>paleturquoise</td>
  20048. </tr>
  20049. <tr>
  20050. <td>color</td>
  20051. <td>mistyrose</td>
  20052. </tr>
  20053. <tr>
  20054. <td>color</td>
  20055. <td>indigo</td>
  20056. </tr>
  20057. </tbody>
  20058. </table>
  20059. <h2 id="tocs_listswiplimit">ListsWiplimit</h2>
  20060. <p><a id="schemalistswiplimit"></a>
  20061. <a id="schema_ListsWiplimit"></a>
  20062. <a id="tocSlistswiplimit"></a>
  20063. <a id="tocslistswiplimit"></a></p>
  20064. <pre class="highlight tab tab-json"><code>{
  20065. <span class="hljs-attr">&quot;value&quot;</span>: <span class="hljs-number">0</span>,
  20066. <span class="hljs-attr">&quot;enabled&quot;</span>: <span class="hljs-literal">true</span>,
  20067. <span class="hljs-attr">&quot;soft&quot;</span>: <span class="hljs-literal">true</span>
  20068. }
  20069. </code></pre>
  20070. <h3 id="properties-18">Properties</h3>
  20071. <table>
  20072. <thead>
  20073. <tr>
  20074. <th>Name</th>
  20075. <th>Type</th>
  20076. <th>Required</th>
  20077. <th>Restrictions</th>
  20078. <th>Description</th>
  20079. </tr>
  20080. </thead>
  20081. <tbody>
  20082. <tr>
  20083. <td>value</td>
  20084. <td>number</td>
  20085. <td>true</td>
  20086. <td>none</td>
  20087. <td>value of the WIP</td>
  20088. </tr>
  20089. <tr>
  20090. <td>enabled</td>
  20091. <td>boolean</td>
  20092. <td>true</td>
  20093. <td>none</td>
  20094. <td>is the WIP enabled</td>
  20095. </tr>
  20096. <tr>
  20097. <td>soft</td>
  20098. <td>boolean</td>
  20099. <td>true</td>
  20100. <td>none</td>
  20101. <td>is the WIP a soft or hard requirement</td>
  20102. </tr>
  20103. </tbody>
  20104. </table>
  20105. <h2 id="tocs_swimlanes">Swimlanes</h2>
  20106. <p><a id="schemaswimlanes"></a>
  20107. <a id="schema_Swimlanes"></a>
  20108. <a id="tocSswimlanes"></a>
  20109. <a id="tocsswimlanes"></a></p>
  20110. <pre class="highlight tab tab-json"><code>{
  20111. <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20112. <span class="hljs-attr">&quot;archived&quot;</span>: <span class="hljs-literal">true</span>,
  20113. <span class="hljs-attr">&quot;archivedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20114. <span class="hljs-attr">&quot;boardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20115. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20116. <span class="hljs-attr">&quot;sort&quot;</span>: <span class="hljs-number">0</span>,
  20117. <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;white&quot;</span>,
  20118. <span class="hljs-attr">&quot;updatedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20119. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20120. <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  20121. }
  20122. </code></pre>
  20123. <p>A swimlane is an line in the kaban board.</p>
  20124. <h3 id="properties-19">Properties</h3>
  20125. <table>
  20126. <thead>
  20127. <tr>
  20128. <th>Name</th>
  20129. <th>Type</th>
  20130. <th>Required</th>
  20131. <th>Restrictions</th>
  20132. <th>Description</th>
  20133. </tr>
  20134. </thead>
  20135. <tbody>
  20136. <tr>
  20137. <td>title</td>
  20138. <td>string</td>
  20139. <td>true</td>
  20140. <td>none</td>
  20141. <td>the title of the swimlane</td>
  20142. </tr>
  20143. <tr>
  20144. <td>archived</td>
  20145. <td>boolean</td>
  20146. <td>true</td>
  20147. <td>none</td>
  20148. <td>is the swimlane archived?</td>
  20149. </tr>
  20150. <tr>
  20151. <td>archivedAt</td>
  20152. <td>string¦null</td>
  20153. <td>false</td>
  20154. <td>none</td>
  20155. <td>latest archiving date of the swimlane</td>
  20156. </tr>
  20157. <tr>
  20158. <td>boardId</td>
  20159. <td>string</td>
  20160. <td>true</td>
  20161. <td>none</td>
  20162. <td>the ID of the board the swimlane is attached to</td>
  20163. </tr>
  20164. <tr>
  20165. <td>createdAt</td>
  20166. <td>string</td>
  20167. <td>true</td>
  20168. <td>none</td>
  20169. <td>creation date of the swimlane</td>
  20170. </tr>
  20171. <tr>
  20172. <td>sort</td>
  20173. <td>number¦null</td>
  20174. <td>false</td>
  20175. <td>none</td>
  20176. <td>the sort value of the swimlane</td>
  20177. </tr>
  20178. <tr>
  20179. <td>color</td>
  20180. <td>string¦null</td>
  20181. <td>false</td>
  20182. <td>none</td>
  20183. <td>the color of the swimlane</td>
  20184. </tr>
  20185. <tr>
  20186. <td>updatedAt</td>
  20187. <td>string¦null</td>
  20188. <td>false</td>
  20189. <td>none</td>
  20190. <td>when was the swimlane last edited</td>
  20191. </tr>
  20192. <tr>
  20193. <td>modifiedAt</td>
  20194. <td>string</td>
  20195. <td>true</td>
  20196. <td>none</td>
  20197. <td>none</td>
  20198. </tr>
  20199. <tr>
  20200. <td>type</td>
  20201. <td>string</td>
  20202. <td>true</td>
  20203. <td>none</td>
  20204. <td>The type of swimlane</td>
  20205. </tr>
  20206. </tbody>
  20207. </table>
  20208. <h4 id="enumerated-values-6">Enumerated Values</h4>
  20209. <table>
  20210. <thead>
  20211. <tr>
  20212. <th>Property</th>
  20213. <th>Value</th>
  20214. </tr>
  20215. </thead>
  20216. <tbody>
  20217. <tr>
  20218. <td>color</td>
  20219. <td>white</td>
  20220. </tr>
  20221. <tr>
  20222. <td>color</td>
  20223. <td>green</td>
  20224. </tr>
  20225. <tr>
  20226. <td>color</td>
  20227. <td>yellow</td>
  20228. </tr>
  20229. <tr>
  20230. <td>color</td>
  20231. <td>orange</td>
  20232. </tr>
  20233. <tr>
  20234. <td>color</td>
  20235. <td>red</td>
  20236. </tr>
  20237. <tr>
  20238. <td>color</td>
  20239. <td>purple</td>
  20240. </tr>
  20241. <tr>
  20242. <td>color</td>
  20243. <td>blue</td>
  20244. </tr>
  20245. <tr>
  20246. <td>color</td>
  20247. <td>sky</td>
  20248. </tr>
  20249. <tr>
  20250. <td>color</td>
  20251. <td>lime</td>
  20252. </tr>
  20253. <tr>
  20254. <td>color</td>
  20255. <td>pink</td>
  20256. </tr>
  20257. <tr>
  20258. <td>color</td>
  20259. <td>black</td>
  20260. </tr>
  20261. <tr>
  20262. <td>color</td>
  20263. <td>silver</td>
  20264. </tr>
  20265. <tr>
  20266. <td>color</td>
  20267. <td>peachpuff</td>
  20268. </tr>
  20269. <tr>
  20270. <td>color</td>
  20271. <td>crimson</td>
  20272. </tr>
  20273. <tr>
  20274. <td>color</td>
  20275. <td>plum</td>
  20276. </tr>
  20277. <tr>
  20278. <td>color</td>
  20279. <td>darkgreen</td>
  20280. </tr>
  20281. <tr>
  20282. <td>color</td>
  20283. <td>slateblue</td>
  20284. </tr>
  20285. <tr>
  20286. <td>color</td>
  20287. <td>magenta</td>
  20288. </tr>
  20289. <tr>
  20290. <td>color</td>
  20291. <td>gold</td>
  20292. </tr>
  20293. <tr>
  20294. <td>color</td>
  20295. <td>navy</td>
  20296. </tr>
  20297. <tr>
  20298. <td>color</td>
  20299. <td>gray</td>
  20300. </tr>
  20301. <tr>
  20302. <td>color</td>
  20303. <td>saddlebrown</td>
  20304. </tr>
  20305. <tr>
  20306. <td>color</td>
  20307. <td>paleturquoise</td>
  20308. </tr>
  20309. <tr>
  20310. <td>color</td>
  20311. <td>mistyrose</td>
  20312. </tr>
  20313. <tr>
  20314. <td>color</td>
  20315. <td>indigo</td>
  20316. </tr>
  20317. </tbody>
  20318. </table>
  20319. <h2 id="tocs_users">Users</h2>
  20320. <p><a id="schemausers"></a>
  20321. <a id="schema_Users"></a>
  20322. <a id="tocSusers"></a>
  20323. <a id="tocsusers"></a></p>
  20324. <pre class="highlight tab tab-json"><code>{
  20325. <span class="hljs-attr">&quot;username&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20326. <span class="hljs-attr">&quot;orgs&quot;</span>: [
  20327. {
  20328. <span class="hljs-attr">&quot;orgId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20329. <span class="hljs-attr">&quot;orgDisplayName&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  20330. }
  20331. ],
  20332. <span class="hljs-attr">&quot;teams&quot;</span>: [
  20333. {
  20334. <span class="hljs-attr">&quot;teamId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20335. <span class="hljs-attr">&quot;teamDisplayName&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  20336. }
  20337. ],
  20338. <span class="hljs-attr">&quot;emails&quot;</span>: [
  20339. {
  20340. <span class="hljs-attr">&quot;address&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20341. <span class="hljs-attr">&quot;verified&quot;</span>: <span class="hljs-literal">true</span>
  20342. }
  20343. ],
  20344. <span class="hljs-attr">&quot;createdAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20345. <span class="hljs-attr">&quot;modifiedAt&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20346. <span class="hljs-attr">&quot;profile&quot;</span>: {
  20347. <span class="hljs-attr">&quot;avatarUrl&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20348. <span class="hljs-attr">&quot;emailBuffer&quot;</span>: [
  20349. <span class="hljs-string">&quot;string&quot;</span>
  20350. ],
  20351. <span class="hljs-attr">&quot;fullname&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20352. <span class="hljs-attr">&quot;showDesktopDragHandles&quot;</span>: <span class="hljs-literal">true</span>,
  20353. <span class="hljs-attr">&quot;hideCheckedItems&quot;</span>: <span class="hljs-literal">true</span>,
  20354. <span class="hljs-attr">&quot;cardMaximized&quot;</span>: <span class="hljs-literal">true</span>,
  20355. <span class="hljs-attr">&quot;customFieldsGrid&quot;</span>: <span class="hljs-literal">true</span>,
  20356. <span class="hljs-attr">&quot;hiddenSystemMessages&quot;</span>: <span class="hljs-literal">true</span>,
  20357. <span class="hljs-attr">&quot;hiddenMinicardLabelText&quot;</span>: <span class="hljs-literal">true</span>,
  20358. <span class="hljs-attr">&quot;initials&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20359. <span class="hljs-attr">&quot;invitedBoards&quot;</span>: [
  20360. <span class="hljs-string">&quot;string&quot;</span>
  20361. ],
  20362. <span class="hljs-attr">&quot;language&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20363. <span class="hljs-attr">&quot;moveAndCopyDialog&quot;</span>: {},
  20364. <span class="hljs-attr">&quot;moveChecklistDialog&quot;</span>: {},
  20365. <span class="hljs-attr">&quot;copyChecklistDialog&quot;</span>: {},
  20366. <span class="hljs-attr">&quot;notifications&quot;</span>: [
  20367. {
  20368. <span class="hljs-attr">&quot;activity&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20369. <span class="hljs-attr">&quot;read&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  20370. }
  20371. ],
  20372. <span class="hljs-attr">&quot;rescueCardDescription&quot;</span>: <span class="hljs-literal">true</span>,
  20373. <span class="hljs-attr">&quot;showCardsCountAt&quot;</span>: <span class="hljs-number">0</span>,
  20374. <span class="hljs-attr">&quot;startDayOfWeek&quot;</span>: <span class="hljs-number">0</span>,
  20375. <span class="hljs-attr">&quot;starredBoards&quot;</span>: [
  20376. <span class="hljs-string">&quot;string&quot;</span>
  20377. ],
  20378. <span class="hljs-attr">&quot;icode&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20379. <span class="hljs-attr">&quot;boardView&quot;</span>: <span class="hljs-string">&quot;board-view-swimlanes&quot;</span>,
  20380. <span class="hljs-attr">&quot;listSortBy&quot;</span>: <span class="hljs-string">&quot;-modifiedat&quot;</span>,
  20381. <span class="hljs-attr">&quot;templatesBoardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20382. <span class="hljs-attr">&quot;cardTemplatesSwimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20383. <span class="hljs-attr">&quot;listTemplatesSwimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20384. <span class="hljs-attr">&quot;boardTemplatesSwimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  20385. },
  20386. <span class="hljs-attr">&quot;services&quot;</span>: {},
  20387. <span class="hljs-attr">&quot;heartbeat&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20388. <span class="hljs-attr">&quot;isAdmin&quot;</span>: <span class="hljs-literal">true</span>,
  20389. <span class="hljs-attr">&quot;createdThroughApi&quot;</span>: <span class="hljs-literal">true</span>,
  20390. <span class="hljs-attr">&quot;loginDisabled&quot;</span>: <span class="hljs-literal">true</span>,
  20391. <span class="hljs-attr">&quot;authenticationMethod&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20392. <span class="hljs-attr">&quot;sessionData&quot;</span>: {
  20393. <span class="hljs-attr">&quot;totalHits&quot;</span>: <span class="hljs-number">0</span>
  20394. },
  20395. <span class="hljs-attr">&quot;importUsernames&quot;</span>: [
  20396. <span class="hljs-string">&quot;string&quot;</span>
  20397. ],
  20398. <span class="hljs-attr">&quot;lastConnectionDate&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  20399. }
  20400. </code></pre>
  20401. <p>A User in wekan</p>
  20402. <h3 id="properties-20">Properties</h3>
  20403. <table>
  20404. <thead>
  20405. <tr>
  20406. <th>Name</th>
  20407. <th>Type</th>
  20408. <th>Required</th>
  20409. <th>Restrictions</th>
  20410. <th>Description</th>
  20411. </tr>
  20412. </thead>
  20413. <tbody>
  20414. <tr>
  20415. <td>username</td>
  20416. <td>string¦null</td>
  20417. <td>false</td>
  20418. <td>none</td>
  20419. <td>the username of the user</td>
  20420. </tr>
  20421. <tr>
  20422. <td>orgs</td>
  20423. <td>[<a href="#schemausersorgs">UsersOrgs</a>]¦null</td>
  20424. <td>false</td>
  20425. <td>none</td>
  20426. <td>the list of organizations that a user belongs to</td>
  20427. </tr>
  20428. <tr>
  20429. <td>teams</td>
  20430. <td>[<a href="#schemausersteams">UsersTeams</a>]¦null</td>
  20431. <td>false</td>
  20432. <td>none</td>
  20433. <td>the list of teams that a user belongs to</td>
  20434. </tr>
  20435. <tr>
  20436. <td>emails</td>
  20437. <td>[<a href="#schemausersemails">UsersEmails</a>]¦null</td>
  20438. <td>false</td>
  20439. <td>none</td>
  20440. <td>the list of emails attached to a user</td>
  20441. </tr>
  20442. <tr>
  20443. <td>createdAt</td>
  20444. <td>string</td>
  20445. <td>true</td>
  20446. <td>none</td>
  20447. <td>creation date of the user</td>
  20448. </tr>
  20449. <tr>
  20450. <td>modifiedAt</td>
  20451. <td>string</td>
  20452. <td>true</td>
  20453. <td>none</td>
  20454. <td>none</td>
  20455. </tr>
  20456. <tr>
  20457. <td>profile</td>
  20458. <td><a href="#schemausersprofile">UsersProfile</a></td>
  20459. <td>false</td>
  20460. <td>none</td>
  20461. <td>none</td>
  20462. </tr>
  20463. <tr>
  20464. <td>services</td>
  20465. <td>object¦null</td>
  20466. <td>false</td>
  20467. <td>none</td>
  20468. <td>services field of the user</td>
  20469. </tr>
  20470. <tr>
  20471. <td>heartbeat</td>
  20472. <td>string¦null</td>
  20473. <td>false</td>
  20474. <td>none</td>
  20475. <td>last time the user has been seen</td>
  20476. </tr>
  20477. <tr>
  20478. <td>isAdmin</td>
  20479. <td>boolean¦null</td>
  20480. <td>false</td>
  20481. <td>none</td>
  20482. <td>is the user an admin of the board?</td>
  20483. </tr>
  20484. <tr>
  20485. <td>createdThroughApi</td>
  20486. <td>boolean¦null</td>
  20487. <td>false</td>
  20488. <td>none</td>
  20489. <td>was the user created through the API?</td>
  20490. </tr>
  20491. <tr>
  20492. <td>loginDisabled</td>
  20493. <td>boolean¦null</td>
  20494. <td>false</td>
  20495. <td>none</td>
  20496. <td>loginDisabled field of the user</td>
  20497. </tr>
  20498. <tr>
  20499. <td>authenticationMethod</td>
  20500. <td>string</td>
  20501. <td>true</td>
  20502. <td>none</td>
  20503. <td>authentication method of the user</td>
  20504. </tr>
  20505. <tr>
  20506. <td>sessionData</td>
  20507. <td><a href="#schemauserssessiondata">UsersSessiondata</a></td>
  20508. <td>false</td>
  20509. <td>none</td>
  20510. <td>none</td>
  20511. </tr>
  20512. <tr>
  20513. <td>importUsernames</td>
  20514. <td>[string]¦null</td>
  20515. <td>false</td>
  20516. <td>none</td>
  20517. <td>username for imported</td>
  20518. </tr>
  20519. <tr>
  20520. <td>lastConnectionDate</td>
  20521. <td>string¦null</td>
  20522. <td>false</td>
  20523. <td>none</td>
  20524. <td>none</td>
  20525. </tr>
  20526. </tbody>
  20527. </table>
  20528. <h2 id="tocs_usersprofile">UsersProfile</h2>
  20529. <p><a id="schemausersprofile"></a>
  20530. <a id="schema_UsersProfile"></a>
  20531. <a id="tocSusersprofile"></a>
  20532. <a id="tocsusersprofile"></a></p>
  20533. <pre class="highlight tab tab-json"><code>{
  20534. <span class="hljs-attr">&quot;avatarUrl&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20535. <span class="hljs-attr">&quot;emailBuffer&quot;</span>: [
  20536. <span class="hljs-string">&quot;string&quot;</span>
  20537. ],
  20538. <span class="hljs-attr">&quot;fullname&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20539. <span class="hljs-attr">&quot;showDesktopDragHandles&quot;</span>: <span class="hljs-literal">true</span>,
  20540. <span class="hljs-attr">&quot;hideCheckedItems&quot;</span>: <span class="hljs-literal">true</span>,
  20541. <span class="hljs-attr">&quot;cardMaximized&quot;</span>: <span class="hljs-literal">true</span>,
  20542. <span class="hljs-attr">&quot;customFieldsGrid&quot;</span>: <span class="hljs-literal">true</span>,
  20543. <span class="hljs-attr">&quot;hiddenSystemMessages&quot;</span>: <span class="hljs-literal">true</span>,
  20544. <span class="hljs-attr">&quot;hiddenMinicardLabelText&quot;</span>: <span class="hljs-literal">true</span>,
  20545. <span class="hljs-attr">&quot;initials&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20546. <span class="hljs-attr">&quot;invitedBoards&quot;</span>: [
  20547. <span class="hljs-string">&quot;string&quot;</span>
  20548. ],
  20549. <span class="hljs-attr">&quot;language&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20550. <span class="hljs-attr">&quot;moveAndCopyDialog&quot;</span>: {},
  20551. <span class="hljs-attr">&quot;moveChecklistDialog&quot;</span>: {},
  20552. <span class="hljs-attr">&quot;copyChecklistDialog&quot;</span>: {},
  20553. <span class="hljs-attr">&quot;notifications&quot;</span>: [
  20554. {
  20555. <span class="hljs-attr">&quot;activity&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20556. <span class="hljs-attr">&quot;read&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  20557. }
  20558. ],
  20559. <span class="hljs-attr">&quot;rescueCardDescription&quot;</span>: <span class="hljs-literal">true</span>,
  20560. <span class="hljs-attr">&quot;showCardsCountAt&quot;</span>: <span class="hljs-number">0</span>,
  20561. <span class="hljs-attr">&quot;startDayOfWeek&quot;</span>: <span class="hljs-number">0</span>,
  20562. <span class="hljs-attr">&quot;starredBoards&quot;</span>: [
  20563. <span class="hljs-string">&quot;string&quot;</span>
  20564. ],
  20565. <span class="hljs-attr">&quot;icode&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20566. <span class="hljs-attr">&quot;boardView&quot;</span>: <span class="hljs-string">&quot;board-view-swimlanes&quot;</span>,
  20567. <span class="hljs-attr">&quot;listSortBy&quot;</span>: <span class="hljs-string">&quot;-modifiedat&quot;</span>,
  20568. <span class="hljs-attr">&quot;templatesBoardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20569. <span class="hljs-attr">&quot;cardTemplatesSwimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20570. <span class="hljs-attr">&quot;listTemplatesSwimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20571. <span class="hljs-attr">&quot;boardTemplatesSwimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  20572. }
  20573. </code></pre>
  20574. <h3 id="properties-21">Properties</h3>
  20575. <table>
  20576. <thead>
  20577. <tr>
  20578. <th>Name</th>
  20579. <th>Type</th>
  20580. <th>Required</th>
  20581. <th>Restrictions</th>
  20582. <th>Description</th>
  20583. </tr>
  20584. </thead>
  20585. <tbody>
  20586. <tr>
  20587. <td>avatarUrl</td>
  20588. <td>string</td>
  20589. <td>false</td>
  20590. <td>none</td>
  20591. <td>URL of the avatar of the user</td>
  20592. </tr>
  20593. <tr>
  20594. <td>emailBuffer</td>
  20595. <td>[string]</td>
  20596. <td>false</td>
  20597. <td>none</td>
  20598. <td>list of email buffers of the user</td>
  20599. </tr>
  20600. <tr>
  20601. <td>fullname</td>
  20602. <td>string</td>
  20603. <td>false</td>
  20604. <td>none</td>
  20605. <td>full name of the user</td>
  20606. </tr>
  20607. <tr>
  20608. <td>showDesktopDragHandles</td>
  20609. <td>boolean</td>
  20610. <td>false</td>
  20611. <td>none</td>
  20612. <td>does the user want to show desktop drag handles?</td>
  20613. </tr>
  20614. <tr>
  20615. <td>hideCheckedItems</td>
  20616. <td>boolean</td>
  20617. <td>false</td>
  20618. <td>none</td>
  20619. <td>does the user want to hide checked checklist items?</td>
  20620. </tr>
  20621. <tr>
  20622. <td>cardMaximized</td>
  20623. <td>boolean</td>
  20624. <td>false</td>
  20625. <td>none</td>
  20626. <td>has user clicked maximize card?</td>
  20627. </tr>
  20628. <tr>
  20629. <td>customFieldsGrid</td>
  20630. <td>boolean</td>
  20631. <td>false</td>
  20632. <td>none</td>
  20633. <td>has user at card Custom Fields have Grid (false) or one per row (true) layout?</td>
  20634. </tr>
  20635. <tr>
  20636. <td>hiddenSystemMessages</td>
  20637. <td>boolean</td>
  20638. <td>false</td>
  20639. <td>none</td>
  20640. <td>does the user want to hide system messages?</td>
  20641. </tr>
  20642. <tr>
  20643. <td>hiddenMinicardLabelText</td>
  20644. <td>boolean</td>
  20645. <td>false</td>
  20646. <td>none</td>
  20647. <td>does the user want to hide minicard label texts?</td>
  20648. </tr>
  20649. <tr>
  20650. <td>initials</td>
  20651. <td>string</td>
  20652. <td>false</td>
  20653. <td>none</td>
  20654. <td>initials of the user</td>
  20655. </tr>
  20656. <tr>
  20657. <td>invitedBoards</td>
  20658. <td>[string]</td>
  20659. <td>false</td>
  20660. <td>none</td>
  20661. <td>board IDs the user has been invited to</td>
  20662. </tr>
  20663. <tr>
  20664. <td>language</td>
  20665. <td>string</td>
  20666. <td>false</td>
  20667. <td>none</td>
  20668. <td>language of the user</td>
  20669. </tr>
  20670. <tr>
  20671. <td>moveAndCopyDialog</td>
  20672. <td>object</td>
  20673. <td>false</td>
  20674. <td>none</td>
  20675. <td>move and copy card dialog</td>
  20676. </tr>
  20677. <tr>
  20678. <td>moveChecklistDialog</td>
  20679. <td>object</td>
  20680. <td>false</td>
  20681. <td>none</td>
  20682. <td>move checklist dialog</td>
  20683. </tr>
  20684. <tr>
  20685. <td>copyChecklistDialog</td>
  20686. <td>object</td>
  20687. <td>false</td>
  20688. <td>none</td>
  20689. <td>copy checklist dialog</td>
  20690. </tr>
  20691. <tr>
  20692. <td>notifications</td>
  20693. <td>[<a href="#schemausersprofilenotifications">UsersProfileNotifications</a>]</td>
  20694. <td>false</td>
  20695. <td>none</td>
  20696. <td>enabled notifications for the user</td>
  20697. </tr>
  20698. <tr>
  20699. <td>rescueCardDescription</td>
  20700. <td>boolean</td>
  20701. <td>false</td>
  20702. <td>none</td>
  20703. <td>show dialog for saving card description on unintentional card closing</td>
  20704. </tr>
  20705. <tr>
  20706. <td>showCardsCountAt</td>
  20707. <td>number</td>
  20708. <td>false</td>
  20709. <td>none</td>
  20710. <td>showCardCountAt field of the user</td>
  20711. </tr>
  20712. <tr>
  20713. <td>startDayOfWeek</td>
  20714. <td>number</td>
  20715. <td>false</td>
  20716. <td>none</td>
  20717. <td>startDayOfWeek field of the user</td>
  20718. </tr>
  20719. <tr>
  20720. <td>starredBoards</td>
  20721. <td>[string]</td>
  20722. <td>false</td>
  20723. <td>none</td>
  20724. <td>list of starred board IDs</td>
  20725. </tr>
  20726. <tr>
  20727. <td>icode</td>
  20728. <td>string</td>
  20729. <td>false</td>
  20730. <td>none</td>
  20731. <td>icode</td>
  20732. </tr>
  20733. <tr>
  20734. <td>boardView</td>
  20735. <td>string</td>
  20736. <td>false</td>
  20737. <td>none</td>
  20738. <td>boardView field of the user</td>
  20739. </tr>
  20740. <tr>
  20741. <td>listSortBy</td>
  20742. <td>string</td>
  20743. <td>false</td>
  20744. <td>none</td>
  20745. <td>default sort list for user</td>
  20746. </tr>
  20747. <tr>
  20748. <td>templatesBoardId</td>
  20749. <td>string</td>
  20750. <td>true</td>
  20751. <td>none</td>
  20752. <td>Reference to the templates board</td>
  20753. </tr>
  20754. <tr>
  20755. <td>cardTemplatesSwimlaneId</td>
  20756. <td>string</td>
  20757. <td>true</td>
  20758. <td>none</td>
  20759. <td>Reference to the card templates swimlane Id</td>
  20760. </tr>
  20761. <tr>
  20762. <td>listTemplatesSwimlaneId</td>
  20763. <td>string</td>
  20764. <td>true</td>
  20765. <td>none</td>
  20766. <td>Reference to the list templates swimlane Id</td>
  20767. </tr>
  20768. <tr>
  20769. <td>boardTemplatesSwimlaneId</td>
  20770. <td>string</td>
  20771. <td>true</td>
  20772. <td>none</td>
  20773. <td>Reference to the board templates swimlane Id</td>
  20774. </tr>
  20775. </tbody>
  20776. </table>
  20777. <h4 id="enumerated-values-7">Enumerated Values</h4>
  20778. <table>
  20779. <thead>
  20780. <tr>
  20781. <th>Property</th>
  20782. <th>Value</th>
  20783. </tr>
  20784. </thead>
  20785. <tbody>
  20786. <tr>
  20787. <td>boardView</td>
  20788. <td>board-view-swimlanes</td>
  20789. </tr>
  20790. <tr>
  20791. <td>boardView</td>
  20792. <td>board-view-lists</td>
  20793. </tr>
  20794. <tr>
  20795. <td>boardView</td>
  20796. <td>board-view-cal</td>
  20797. </tr>
  20798. <tr>
  20799. <td>listSortBy</td>
  20800. <td>-modifiedat</td>
  20801. </tr>
  20802. <tr>
  20803. <td>listSortBy</td>
  20804. <td>modifiedat</td>
  20805. </tr>
  20806. <tr>
  20807. <td>listSortBy</td>
  20808. <td>-title</td>
  20809. </tr>
  20810. <tr>
  20811. <td>listSortBy</td>
  20812. <td>title</td>
  20813. </tr>
  20814. <tr>
  20815. <td>listSortBy</td>
  20816. <td>-sort</td>
  20817. </tr>
  20818. <tr>
  20819. <td>listSortBy</td>
  20820. <td>sort</td>
  20821. </tr>
  20822. </tbody>
  20823. </table>
  20824. <h2 id="tocs_userssessiondata">UsersSessiondata</h2>
  20825. <p><a id="schemauserssessiondata"></a>
  20826. <a id="schema_UsersSessiondata"></a>
  20827. <a id="tocSuserssessiondata"></a>
  20828. <a id="tocsuserssessiondata"></a></p>
  20829. <pre class="highlight tab tab-json"><code>{
  20830. <span class="hljs-attr">&quot;totalHits&quot;</span>: <span class="hljs-number">0</span>
  20831. }
  20832. </code></pre>
  20833. <h3 id="properties-22">Properties</h3>
  20834. <table>
  20835. <thead>
  20836. <tr>
  20837. <th>Name</th>
  20838. <th>Type</th>
  20839. <th>Required</th>
  20840. <th>Restrictions</th>
  20841. <th>Description</th>
  20842. </tr>
  20843. </thead>
  20844. <tbody>
  20845. <tr>
  20846. <td>totalHits</td>
  20847. <td>number</td>
  20848. <td>false</td>
  20849. <td>none</td>
  20850. <td>Total hits from last searchquery['members.userId'] = Meteor.userId();<br />last hit that was returned</td>
  20851. </tr>
  20852. </tbody>
  20853. </table>
  20854. <h2 id="tocs_usersorgs">UsersOrgs</h2>
  20855. <p><a id="schemausersorgs"></a>
  20856. <a id="schema_UsersOrgs"></a>
  20857. <a id="tocSusersorgs"></a>
  20858. <a id="tocsusersorgs"></a></p>
  20859. <pre class="highlight tab tab-json"><code>{
  20860. <span class="hljs-attr">&quot;orgId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20861. <span class="hljs-attr">&quot;orgDisplayName&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  20862. }
  20863. </code></pre>
  20864. <h3 id="properties-23">Properties</h3>
  20865. <table>
  20866. <thead>
  20867. <tr>
  20868. <th>Name</th>
  20869. <th>Type</th>
  20870. <th>Required</th>
  20871. <th>Restrictions</th>
  20872. <th>Description</th>
  20873. </tr>
  20874. </thead>
  20875. <tbody>
  20876. <tr>
  20877. <td>orgId</td>
  20878. <td>string</td>
  20879. <td>true</td>
  20880. <td>none</td>
  20881. <td>The uniq ID of the organization</td>
  20882. </tr>
  20883. <tr>
  20884. <td>orgDisplayName</td>
  20885. <td>string</td>
  20886. <td>true</td>
  20887. <td>none</td>
  20888. <td>The display name of the organization</td>
  20889. </tr>
  20890. </tbody>
  20891. </table>
  20892. <h2 id="tocs_usersteams">UsersTeams</h2>
  20893. <p><a id="schemausersteams"></a>
  20894. <a id="schema_UsersTeams"></a>
  20895. <a id="tocSusersteams"></a>
  20896. <a id="tocsusersteams"></a></p>
  20897. <pre class="highlight tab tab-json"><code>{
  20898. <span class="hljs-attr">&quot;teamId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20899. <span class="hljs-attr">&quot;teamDisplayName&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  20900. }
  20901. </code></pre>
  20902. <h3 id="properties-24">Properties</h3>
  20903. <table>
  20904. <thead>
  20905. <tr>
  20906. <th>Name</th>
  20907. <th>Type</th>
  20908. <th>Required</th>
  20909. <th>Restrictions</th>
  20910. <th>Description</th>
  20911. </tr>
  20912. </thead>
  20913. <tbody>
  20914. <tr>
  20915. <td>teamId</td>
  20916. <td>string</td>
  20917. <td>true</td>
  20918. <td>none</td>
  20919. <td>The uniq ID of the team</td>
  20920. </tr>
  20921. <tr>
  20922. <td>teamDisplayName</td>
  20923. <td>string</td>
  20924. <td>true</td>
  20925. <td>none</td>
  20926. <td>The display name of the team</td>
  20927. </tr>
  20928. </tbody>
  20929. </table>
  20930. <h2 id="tocs_usersemails">UsersEmails</h2>
  20931. <p><a id="schemausersemails"></a>
  20932. <a id="schema_UsersEmails"></a>
  20933. <a id="tocSusersemails"></a>
  20934. <a id="tocsusersemails"></a></p>
  20935. <pre class="highlight tab tab-json"><code>{
  20936. <span class="hljs-attr">&quot;address&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20937. <span class="hljs-attr">&quot;verified&quot;</span>: <span class="hljs-literal">true</span>
  20938. }
  20939. </code></pre>
  20940. <h3 id="properties-25">Properties</h3>
  20941. <table>
  20942. <thead>
  20943. <tr>
  20944. <th>Name</th>
  20945. <th>Type</th>
  20946. <th>Required</th>
  20947. <th>Restrictions</th>
  20948. <th>Description</th>
  20949. </tr>
  20950. </thead>
  20951. <tbody>
  20952. <tr>
  20953. <td>address</td>
  20954. <td>string</td>
  20955. <td>true</td>
  20956. <td>none</td>
  20957. <td>The email address</td>
  20958. </tr>
  20959. <tr>
  20960. <td>verified</td>
  20961. <td>boolean</td>
  20962. <td>true</td>
  20963. <td>none</td>
  20964. <td>Has the email been verified</td>
  20965. </tr>
  20966. </tbody>
  20967. </table>
  20968. <h2 id="tocs_usersprofilemoveandcopydialog">UsersProfileMoveandcopydialog</h2>
  20969. <p><a id="schemausersprofilemoveandcopydialog"></a>
  20970. <a id="schema_UsersProfileMoveandcopydialog"></a>
  20971. <a id="tocSusersprofilemoveandcopydialog"></a>
  20972. <a id="tocsusersprofilemoveandcopydialog"></a></p>
  20973. <pre class="highlight tab tab-json"><code>{
  20974. <span class="hljs-attr">&quot;boardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20975. <span class="hljs-attr">&quot;swimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  20976. <span class="hljs-attr">&quot;listId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  20977. }
  20978. </code></pre>
  20979. <h3 id="properties-26">Properties</h3>
  20980. <table>
  20981. <thead>
  20982. <tr>
  20983. <th>Name</th>
  20984. <th>Type</th>
  20985. <th>Required</th>
  20986. <th>Restrictions</th>
  20987. <th>Description</th>
  20988. </tr>
  20989. </thead>
  20990. <tbody>
  20991. <tr>
  20992. <td>boardId</td>
  20993. <td>string</td>
  20994. <td>true</td>
  20995. <td>none</td>
  20996. <td>last selected board id</td>
  20997. </tr>
  20998. <tr>
  20999. <td>swimlaneId</td>
  21000. <td>string</td>
  21001. <td>true</td>
  21002. <td>none</td>
  21003. <td>last selected swimlane id</td>
  21004. </tr>
  21005. <tr>
  21006. <td>listId</td>
  21007. <td>string</td>
  21008. <td>true</td>
  21009. <td>none</td>
  21010. <td>last selected list id</td>
  21011. </tr>
  21012. </tbody>
  21013. </table>
  21014. <h2 id="tocs_usersprofilemovechecklistdialog">UsersProfileMovechecklistdialog</h2>
  21015. <p><a id="schemausersprofilemovechecklistdialog"></a>
  21016. <a id="schema_UsersProfileMovechecklistdialog"></a>
  21017. <a id="tocSusersprofilemovechecklistdialog"></a>
  21018. <a id="tocsusersprofilemovechecklistdialog"></a></p>
  21019. <pre class="highlight tab tab-json"><code>{
  21020. <span class="hljs-attr">&quot;boardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  21021. <span class="hljs-attr">&quot;swimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  21022. <span class="hljs-attr">&quot;listId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  21023. <span class="hljs-attr">&quot;cardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  21024. }
  21025. </code></pre>
  21026. <h3 id="properties-27">Properties</h3>
  21027. <table>
  21028. <thead>
  21029. <tr>
  21030. <th>Name</th>
  21031. <th>Type</th>
  21032. <th>Required</th>
  21033. <th>Restrictions</th>
  21034. <th>Description</th>
  21035. </tr>
  21036. </thead>
  21037. <tbody>
  21038. <tr>
  21039. <td>boardId</td>
  21040. <td>string</td>
  21041. <td>true</td>
  21042. <td>none</td>
  21043. <td>last selected board id</td>
  21044. </tr>
  21045. <tr>
  21046. <td>swimlaneId</td>
  21047. <td>string</td>
  21048. <td>true</td>
  21049. <td>none</td>
  21050. <td>last selected swimlane id</td>
  21051. </tr>
  21052. <tr>
  21053. <td>listId</td>
  21054. <td>string</td>
  21055. <td>true</td>
  21056. <td>none</td>
  21057. <td>last selected list id</td>
  21058. </tr>
  21059. <tr>
  21060. <td>cardId</td>
  21061. <td>string</td>
  21062. <td>true</td>
  21063. <td>none</td>
  21064. <td>last selected card id</td>
  21065. </tr>
  21066. </tbody>
  21067. </table>
  21068. <h2 id="tocs_usersprofilecopychecklistdialog">UsersProfileCopychecklistdialog</h2>
  21069. <p><a id="schemausersprofilecopychecklistdialog"></a>
  21070. <a id="schema_UsersProfileCopychecklistdialog"></a>
  21071. <a id="tocSusersprofilecopychecklistdialog"></a>
  21072. <a id="tocsusersprofilecopychecklistdialog"></a></p>
  21073. <pre class="highlight tab tab-json"><code>{
  21074. <span class="hljs-attr">&quot;boardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  21075. <span class="hljs-attr">&quot;swimlaneId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  21076. <span class="hljs-attr">&quot;listId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  21077. <span class="hljs-attr">&quot;cardId&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  21078. }
  21079. </code></pre>
  21080. <h3 id="properties-28">Properties</h3>
  21081. <table>
  21082. <thead>
  21083. <tr>
  21084. <th>Name</th>
  21085. <th>Type</th>
  21086. <th>Required</th>
  21087. <th>Restrictions</th>
  21088. <th>Description</th>
  21089. </tr>
  21090. </thead>
  21091. <tbody>
  21092. <tr>
  21093. <td>boardId</td>
  21094. <td>string</td>
  21095. <td>true</td>
  21096. <td>none</td>
  21097. <td>last selected board id</td>
  21098. </tr>
  21099. <tr>
  21100. <td>swimlaneId</td>
  21101. <td>string</td>
  21102. <td>true</td>
  21103. <td>none</td>
  21104. <td>last selected swimlane id</td>
  21105. </tr>
  21106. <tr>
  21107. <td>listId</td>
  21108. <td>string</td>
  21109. <td>true</td>
  21110. <td>none</td>
  21111. <td>last selected list id</td>
  21112. </tr>
  21113. <tr>
  21114. <td>cardId</td>
  21115. <td>string</td>
  21116. <td>true</td>
  21117. <td>none</td>
  21118. <td>last selected card id</td>
  21119. </tr>
  21120. </tbody>
  21121. </table>
  21122. <h2 id="tocs_usersprofilenotifications">UsersProfileNotifications</h2>
  21123. <p><a id="schemausersprofilenotifications"></a>
  21124. <a id="schema_UsersProfileNotifications"></a>
  21125. <a id="tocSusersprofilenotifications"></a>
  21126. <a id="tocsusersprofilenotifications"></a></p>
  21127. <pre class="highlight tab tab-json"><code>{
  21128. <span class="hljs-attr">&quot;activity&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
  21129. <span class="hljs-attr">&quot;read&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
  21130. }
  21131. </code></pre>
  21132. <h3 id="properties-29">Properties</h3>
  21133. <table>
  21134. <thead>
  21135. <tr>
  21136. <th>Name</th>
  21137. <th>Type</th>
  21138. <th>Required</th>
  21139. <th>Restrictions</th>
  21140. <th>Description</th>
  21141. </tr>
  21142. </thead>
  21143. <tbody>
  21144. <tr>
  21145. <td>activity</td>
  21146. <td>string</td>
  21147. <td>true</td>
  21148. <td>none</td>
  21149. <td>The id of the activity this notification references</td>
  21150. </tr>
  21151. <tr>
  21152. <td>read</td>
  21153. <td>string</td>
  21154. <td>false</td>
  21155. <td>none</td>
  21156. <td>the date on which this notification was read</td>
  21157. </tr>
  21158. </tbody>
  21159. </table>
  21160. <!-- Renderer: Shins v2.6.0 -->
  21161. <!-- Generator: Widdershins v4.0.1 -->
  21162. <!-- backwards compatibility -->
  21163. <!-- backwards compatibility -->
  21164. <!-- backwards compatibility -->
  21165. <!-- backwards compatibility -->
  21166. <!-- backwards compatibility -->
  21167. <!-- backwards compatibility -->
  21168. <!-- backwards compatibility -->
  21169. <!-- backwards compatibility -->
  21170. <!-- backwards compatibility -->
  21171. <!-- backwards compatibility -->
  21172. <!-- backwards compatibility -->
  21173. <!-- backwards compatibility -->
  21174. <!-- backwards compatibility -->
  21175. <!-- backwards compatibility -->
  21176. <!-- backwards compatibility -->
  21177. <!-- backwards compatibility -->
  21178. <!-- backwards compatibility -->
  21179. <!-- backwards compatibility -->
  21180. <!-- backwards compatibility -->
  21181. <!-- backwards compatibility -->
  21182. <!-- backwards compatibility -->
  21183. <!-- backwards compatibility -->
  21184. <!-- backwards compatibility -->
  21185. <!-- backwards compatibility -->
  21186. <!-- backwards compatibility -->
  21187. <!-- backwards compatibility -->
  21188. <!-- backwards compatibility -->
  21189. <!-- backwards compatibility -->
  21190. <!-- backwards compatibility -->
  21191. </div>
  21192. <div class="dark-box">
  21193. <div class="lang-selector">
  21194. <a href="#" data-language-name="shell">Shell</a>
  21195. <a href="#" data-language-name="http">HTTP</a>
  21196. <a href="#" data-language-name="javascript">JavaScript</a>
  21197. <a href="#" data-language-name="javascript--nodejs">Node.js</a>
  21198. <a href="#" data-language-name="ruby">Ruby</a>
  21199. <a href="#" data-language-name="python">Python</a>
  21200. <a href="#" data-language-name="java">Java</a>
  21201. <a href="#" data-language-name="go">Go</a>
  21202. <a href="#" data-language-name="php">PHP</a>
  21203. </div>
  21204. </div>
  21205. </div>
  21206. </body>
  21207. </html>