[{"data":1,"prerenderedAt":1686},["ShallowReactive",2],{"api-nav":3,"api-spec:index":351,"api-spec:op:get-group-challenge-group":636,"api-permissions-guide":1147,"api-reference-doc:get-group-challenge-group":1148},[4,28,57,95,115,301,317,331],{"id":5,"title":6,"links":7,"groups":27},"start","Start here",[8,11,15,18,21,24],{"title":9,"to":10},"Overview","\u002Fapi",{"title":12,"to":13,"status":14},"Quickstart","\u002Fapi\u002Fquickstart","available",{"title":16,"to":17,"status":14},"Environments","\u002Fapi\u002Fenvironments",{"title":19,"to":20,"status":14},"Authentication","\u002Fapi\u002Fauthentication",{"title":22,"to":23,"status":14},"Organizations","\u002Fapi\u002Forganizations",{"title":25,"to":26,"status":14},"Permissions","\u002Fapi\u002Fpermissions",[],{"id":29,"title":30,"links":31,"groups":56},"concepts","Concepts",[32,35,38,41,44,47,50,53],{"title":33,"to":34,"status":14},"Requests and responses","\u002Fapi\u002Frequests-and-responses",{"title":36,"to":37,"status":14},"Identifiers","\u002Fapi\u002Fidentifiers",{"title":39,"to":40,"status":14},"Pagination","\u002Fapi\u002Fpagination",{"title":42,"to":43},"Errors","\u002Fapi\u002Ferrors",{"title":45,"to":46,"status":14},"Rate limits","\u002Fapi\u002Frate-limits",{"title":48,"to":49,"status":14},"Retries","\u002Fapi\u002Fretries-and-idempotency",{"title":51,"to":52,"status":14},"Security","\u002Fapi\u002Fsecurity",{"title":54,"to":55,"status":14},"Versioning","\u002Fapi\u002Fversioning",[],{"id":58,"title":59,"links":60,"groups":94},"resources","Guides",[61,64,67,70,73,76,79,82,85,88,91],{"title":62,"to":63,"status":14},"Students","\u002Fapi\u002Fguides\u002Fstudents",{"title":65,"to":66,"status":14},"Bulk registration","\u002Fapi\u002Fguides\u002Fbulk-registration",{"title":68,"to":69,"status":14},"Passwords","\u002Fapi\u002Fguides\u002Fpasswords",{"title":71,"to":72,"status":14},"Supervisors","\u002Fapi\u002Fguides\u002Fsupervisors",{"title":74,"to":75,"status":14},"Reference data","\u002Fapi\u002Fguides\u002Freference-data",{"title":77,"to":78,"status":14},"API account","\u002Fapi\u002Fguides\u002Fapi-account",{"title":80,"to":81,"status":14},"Sign-in links","\u002Fapi\u002Fguides\u002Fsign-in-links",{"title":83,"to":84,"status":14},"Exams","\u002Fapi\u002Fguides\u002Fexams",{"title":86,"to":87,"status":14},"Applications","\u002Fapi\u002Fguides\u002Fapplications",{"title":89,"to":90,"status":14},"Group challenges","\u002Fapi\u002Fguides\u002Fgroup-challenges",{"title":92,"to":93,"status":14},"Certificates and reports","\u002Fapi\u002Fguides\u002Fcertificates-and-reports",[],{"id":96,"title":97,"links":98,"groups":114},"tutorials","Tutorials",[99,102,105,108,111],{"title":100,"to":101,"status":14},"Register and apply","\u002Fapi\u002Ftutorials\u002Fregister-and-apply",{"title":103,"to":104,"status":14},"Send a student to the panel","\u002Fapi\u002Ftutorials\u002Fsend-student-to-panel",{"title":106,"to":107,"status":14},"Change an application","\u002Fapi\u002Ftutorials\u002Fchange-an-application",{"title":109,"to":110,"status":14},"Collect results","\u002Fapi\u002Ftutorials\u002Fcollect-results",{"title":112,"to":113,"status":14},"Token handling","\u002Fapi\u002Ftutorials\u002Ftoken-handling",[],{"id":116,"title":117,"links":118,"groups":125},"reference","Reference",[119,122],{"title":120,"to":121},"All endpoints","\u002Fapi\u002Freference",{"title":123,"to":124},"Sandbox console","\u002Fapi\u002Fconsole",[126,135,145,166,206,212,230,255,271],{"tag":127,"slug":128,"links":129},"Health","health",[130],{"title":131,"to":132,"method":133,"deprecated":134},"Check that the API is up","\u002Fapi\u002Freference\u002Fget-health","GET",false,{"tag":77,"slug":136,"links":137},"api-account",[138,142],{"title":139,"to":140,"method":141,"deprecated":134},"Revoke the token you send, before it expires","\u002Fapi\u002Freference\u002Frevoke-token","POST",{"title":143,"to":144,"method":133,"deprecated":134},"Fetch the API account your token belongs to","\u002Fapi\u002Freference\u002Fget-current-api-account",{"tag":74,"slug":146,"links":147},"reference-data",[148,151,154,157,160,163],{"title":149,"to":150,"method":133,"deprecated":134},"List the countries a student can be registered in","\u002Fapi\u002Freference\u002Flist-countries",{"title":152,"to":153,"method":133,"deprecated":134},"Fetch one country by its id","\u002Fapi\u002Freference\u002Fget-country",{"title":155,"to":156,"method":133,"deprecated":134},"List the grades a student can be registered with","\u002Fapi\u002Freference\u002Flist-grades",{"title":158,"to":159,"method":133,"deprecated":134},"Fetch one grade by its id","\u002Fapi\u002Freference\u002Fget-grade",{"title":161,"to":162,"method":133,"deprecated":134},"List the organizations and their ids","\u002Fapi\u002Freference\u002Flist-organizations",{"title":164,"to":165,"method":133,"deprecated":134},"Fetch one organization by its id","\u002Fapi\u002Freference\u002Fget-organization",{"tag":62,"slug":167,"links":168},"students",[169,172,175,178,181,184,187,191,194,197,200,203],{"title":170,"to":171,"method":133,"deprecated":134},"List your students","\u002Fapi\u002Freference\u002Flist-students",{"title":173,"to":174,"method":141,"deprecated":134},"Register a student","\u002Fapi\u002Freference\u002Fregister-student",{"title":176,"to":177,"method":141,"deprecated":134},"Check a registration without registering the student","\u002Fapi\u002Freference\u002Fcheck-student-registration",{"title":179,"to":180,"method":141,"deprecated":134},"Register many students at once","\u002Fapi\u002Freference\u002Fcreate-student-import",{"title":182,"to":183,"method":133,"deprecated":134},"Follow a batch of students you sent","\u002Fapi\u002Freference\u002Fget-student-import",{"title":185,"to":186,"method":133,"deprecated":134},"Fetch one of your students","\u002Fapi\u002Freference\u002Fget-student",{"title":188,"to":189,"method":190,"deprecated":134},"Update one of your students","\u002Fapi\u002Freference\u002Fupdate-student","PUT",{"title":192,"to":193,"method":190,"deprecated":134},"Set the sign-in password of one of your students","\u002Fapi\u002Freference\u002Fset-student-password",{"title":195,"to":196,"method":133,"deprecated":134},"List your students who can use this organization","\u002Fapi\u002Freference\u002Flist-org-students",{"title":198,"to":199,"method":133,"deprecated":134},"Fetch one of your students, if they can use this organization","\u002Fapi\u002Freference\u002Fget-org-student",{"title":201,"to":202,"method":190,"deprecated":134},"Update one of your students and give them access to this organization","\u002Fapi\u002Freference\u002Fupdate-org-student",{"title":204,"to":205,"method":190,"deprecated":134},"Link one of your students to a supervisor on this organization","\u002Fapi\u002Freference\u002Flink-student-supervisor",{"tag":80,"slug":207,"links":208},"sign-in-links",[209],{"title":210,"to":211,"method":141,"deprecated":134},"Create a single-use sign-in link for one of your students","\u002Fapi\u002Freference\u002Fcreate-signin-link",{"tag":83,"slug":213,"links":214},"exams",[215,218,221,224,227],{"title":216,"to":217,"method":133,"deprecated":134},"List the exams open for applications","\u002Fapi\u002Freference\u002Flist-exams",{"title":219,"to":220,"method":133,"deprecated":134},"List an organization’s exam categories","\u002Fapi\u002Freference\u002Flist-exam-categories",{"title":222,"to":223,"method":133,"deprecated":134},"Fetch one exam category","\u002Fapi\u002Freference\u002Fget-exam-category",{"title":225,"to":226,"method":133,"deprecated":134},"List the exams one of your students can apply to","\u002Fapi\u002Freference\u002Flist-available-exams",{"title":228,"to":229,"method":133,"deprecated":134},"Fetch one exam that is open for applications","\u002Fapi\u002Freference\u002Fget-exam",{"tag":86,"slug":231,"links":232},"applications",[233,236,239,242,245,248,251],{"title":234,"to":235,"method":133,"deprecated":134},"List your students’ applications in this organization","\u002Fapi\u002Freference\u002Flist-applications",{"title":237,"to":238,"method":141,"deprecated":134},"Enter one of your students for an exam","\u002Fapi\u002Freference\u002Fcreate-application",{"title":240,"to":241,"method":133,"deprecated":134},"List your students’ applications for one exam","\u002Fapi\u002Freference\u002Flist-exam-applications",{"title":243,"to":244,"method":133,"deprecated":134},"List one of your students’ applications in this organization","\u002Fapi\u002Freference\u002Flist-student-applications",{"title":246,"to":247,"method":133,"deprecated":134},"Fetch one of your students’ applications","\u002Fapi\u002Freference\u002Fget-application",{"title":249,"to":250,"method":190,"deprecated":134},"Move one of your students’ applications to another exam","\u002Fapi\u002Freference\u002Fmove-application",{"title":252,"to":253,"method":254,"deprecated":134},"Withdraw one of your students from an exam","\u002Fapi\u002Freference\u002Fdelete-application","DELETE",{"tag":256,"slug":257,"links":258},"Documents","documents",[259,262,265,268],{"title":260,"to":261,"method":133,"deprecated":134},"Download a certificate file","\u002Fapi\u002Freference\u002Fdownload-certificate",{"title":263,"to":264,"method":133,"deprecated":134},"List one of your students’ released certificates","\u002Fapi\u002Freference\u002Flist-student-certificates",{"title":266,"to":267,"method":133,"deprecated":134},"Download a result report file","\u002Fapi\u002Freference\u002Fdownload-report",{"title":269,"to":270,"method":133,"deprecated":134},"List one of your students’ released result reports","\u002Fapi\u002Freference\u002Flist-student-reports",{"tag":89,"slug":272,"links":273},"group-challenges",[274,277,280,283,286,289,292,295,298],{"title":275,"to":276,"method":133,"deprecated":134},"List the group challenges an organization runs","\u002Fapi\u002Freference\u002Flist-group-challenges",{"title":278,"to":279,"method":133,"deprecated":134},"Fetch one group challenge","\u002Fapi\u002Freference\u002Fget-group-challenge",{"title":281,"to":282,"method":133,"deprecated":134},"List the groups your students are in for a group challenge","\u002Fapi\u002Freference\u002Flist-group-challenge-groups",{"title":284,"to":285,"method":133,"deprecated":134},"Fetch one group, with its steps and files","\u002Fapi\u002Freference\u002Fget-group-challenge-group",{"title":287,"to":288,"method":133,"deprecated":134},"List what has happened in one group","\u002Fapi\u002Freference\u002Flist-group-challenge-activity",{"title":290,"to":291,"method":141,"deprecated":134},"Send a group’s finished work for one of your students","\u002Fapi\u002Freference\u002Fsubmit-group-challenge-work",{"title":293,"to":294,"method":141,"deprecated":134},"Submit one step of a group for one of your students","\u002Fapi\u002Freference\u002Fsubmit-group-challenge-step",{"title":296,"to":297,"method":133,"deprecated":134},"List your students’ eligibility and groups for a group challenge","\u002Fapi\u002Freference\u002Flist-group-challenge-students",{"title":299,"to":300,"method":133,"deprecated":134},"Fetch one of your students’ eligibility and group for a group challenge","\u002Fapi\u002Freference\u002Fget-group-challenge-student",{"id":302,"title":303,"links":304,"groups":316},"clients","Clients",[305,307,310,313],{"title":9,"to":306,"status":14},"\u002Fapi\u002Fclients",{"title":308,"to":309,"status":14},"Node.js","\u002Fapi\u002Fclients\u002Fnode",{"title":311,"to":312,"status":14},"PHP","\u002Fapi\u002Fclients\u002Fphp",{"title":314,"to":315,"status":14},"Build your own","\u002Fapi\u002Fclients\u002Fbuild-your-own",[],{"id":318,"title":319,"links":320,"groups":330},"agents","AI agents",[321,324,327],{"title":322,"to":323},"AI connections","\u002Fapi\u002Fmcp",{"title":325,"to":326},"What it can do","\u002Fapi\u002Fmcp\u002Ftools",{"title":328,"to":329},"Agent skills","\u002Fapi\u002Fskills",[],{"id":332,"title":333,"links":334,"groups":350},"help","Help",[335,338,341,344,347],{"title":336,"to":337,"status":14},"Glossary","\u002Fapi\u002Fglossary",{"title":339,"to":340,"status":14},"FAQ","\u002Fapi\u002Ffaq",{"title":342,"to":343,"status":14},"Troubleshooting","\u002Fapi\u002Ftroubleshooting",{"title":345,"to":346,"status":14},"Support","\u002Fapi\u002Fsupport",{"title":348,"to":349},"Changelog","\u002Fapi\u002Fchangelog",[],{"title":352,"version":353,"description":354,"baseUrl":355,"groups":356},"Main Team API","1.2.0","Register your students, enter them for exams, follow their applications, download their certificates and reports, and sign them in to an organization’s panel.\n\nEvery operation except the health check needs a bearer token: a JWT you sign yourself with HS256 and your account’s `apiSecret`. Put your `apiKey` in both the `kid` header and the `sub` claim, and set `iat` and `exp` at most 3600 seconds apart. Every authentication failure answers the same `401 unauthorized`.","https:\u002F\u002Fapi.main-team.org",[357,368,383,419,484,492,522,561,586],{"tag":127,"slug":128,"description":358,"guide":17,"operations":359},"Whether the API is up. No token needed, so it is the first call to make against an environment.",[360],{"operationId":361,"slug":362,"method":133,"path":363,"tag":127,"summary":131,"deprecated":134,"public":364,"permission":365,"scope":366,"order":367},"getHealth","get-health","\u002Fv1\u002Fhealth",true,null,"public",1,{"tag":77,"slug":136,"description":369,"guide":78,"operations":370},"The account your token belongs to, and revoking a token before it expires.",[371,378],{"operationId":372,"slug":373,"method":141,"path":374,"tag":77,"summary":139,"deprecated":134,"public":134,"permission":375,"scope":376,"order":377},"revokeToken","revoke-token","\u002Fv1\u002Fapi-account\u002Frevoke-token","api\u002F*:$org:$ID","flat",2,{"operationId":379,"slug":380,"method":133,"path":381,"tag":77,"summary":143,"deprecated":134,"public":134,"permission":375,"scope":376,"order":382},"getCurrentApiAccount","get-current-api-account","\u002Fv1\u002Fapi-account\u002Fvalidate-me",3,{"tag":74,"slug":146,"description":384,"guide":75,"operations":385},"Countries, grades and organizations. A student’s `country` and `grade` take these `_id`s, and so does every `:organizationId` in a path.",[386,392,397,403,408,414],{"operationId":387,"slug":388,"method":133,"path":389,"tag":74,"summary":149,"deprecated":134,"public":134,"permission":390,"scope":376,"order":391},"listCountries","list-countries","\u002Fv1\u002Fcountry","country\u002Fread:$org:$ID",4,{"operationId":393,"slug":394,"method":133,"path":395,"tag":74,"summary":152,"deprecated":134,"public":134,"permission":390,"scope":376,"order":396},"getCountry","get-country","\u002Fv1\u002Fcountry\u002F{id}",5,{"operationId":398,"slug":399,"method":133,"path":400,"tag":74,"summary":155,"deprecated":134,"public":134,"permission":401,"scope":376,"order":402},"listGrades","list-grades","\u002Fv1\u002Fgrade","grade\u002Fread:$org:$ID",6,{"operationId":404,"slug":405,"method":133,"path":406,"tag":74,"summary":158,"deprecated":134,"public":134,"permission":401,"scope":376,"order":407},"getGrade","get-grade","\u002Fv1\u002Fgrade\u002F{id}",7,{"operationId":409,"slug":410,"method":133,"path":411,"tag":74,"summary":161,"deprecated":134,"public":134,"permission":412,"scope":376,"order":413},"listOrganizations","list-organizations","\u002Fv1\u002Forganization","organization\u002Fread:$org:$ID",8,{"operationId":415,"slug":416,"method":133,"path":417,"tag":74,"summary":164,"deprecated":134,"public":134,"permission":412,"scope":376,"order":418},"getOrganization","get-organization","\u002Fv1\u002Forganization\u002F{id}",9,{"tag":62,"slug":167,"description":420,"guide":63,"operations":421},"Registering your students, reading and updating them, setting a password, and what each organization holds for them. You only ever see the students your account registered.",[422,428,433,438,443,448,453,458,464,470,475,479],{"operationId":423,"slug":424,"method":133,"path":425,"tag":62,"summary":170,"deprecated":134,"public":134,"permission":426,"scope":376,"order":427},"listStudents","list-students","\u002Fv1\u002Fstudent","student\u002Fread:$org:$ID",10,{"operationId":429,"slug":430,"method":141,"path":425,"tag":62,"summary":173,"deprecated":134,"public":134,"permission":431,"scope":376,"order":432},"registerStudent","register-student","student\u002Fcreate:$org:$ID",11,{"operationId":434,"slug":435,"method":141,"path":436,"tag":62,"summary":176,"deprecated":134,"public":134,"permission":431,"scope":376,"order":437},"checkStudentRegistration","check-student-registration","\u002Fv1\u002Fstudent\u002Fcheck",12,{"operationId":439,"slug":440,"method":141,"path":441,"tag":62,"summary":179,"deprecated":134,"public":134,"permission":431,"scope":376,"order":442},"createStudentImport","create-student-import","\u002Fv1\u002Fstudent\u002Fimport",13,{"operationId":444,"slug":445,"method":133,"path":446,"tag":62,"summary":182,"deprecated":134,"public":134,"permission":431,"scope":376,"order":447},"getStudentImport","get-student-import","\u002Fv1\u002Fstudent\u002Fimport\u002F{importId}",14,{"operationId":449,"slug":450,"method":133,"path":451,"tag":62,"summary":185,"deprecated":134,"public":134,"permission":426,"scope":376,"order":452},"getStudent","get-student","\u002Fv1\u002Fstudent\u002F{studentId}",15,{"operationId":454,"slug":455,"method":190,"path":451,"tag":62,"summary":188,"deprecated":134,"public":134,"permission":456,"scope":376,"order":457},"updateStudent","update-student","student\u002Fupdate:$org:$ID",16,{"operationId":459,"slug":460,"method":190,"path":461,"tag":62,"summary":192,"deprecated":134,"public":134,"permission":462,"scope":376,"order":463},"setStudentPassword","set-student-password","\u002Fv1\u002Fstudent\u002F{studentId}\u002Fpassword","auth\u002Fsignin:$org:$ID",17,{"operationId":465,"slug":466,"method":133,"path":467,"tag":62,"summary":195,"deprecated":134,"public":134,"permission":426,"scope":468,"order":469},"listOrgStudents","list-org-students","\u002Fv1\u002F{organizationId}\u002Fstudent","organization",18,{"operationId":471,"slug":472,"method":133,"path":473,"tag":62,"summary":198,"deprecated":134,"public":134,"permission":426,"scope":468,"order":474},"getOrgStudent","get-org-student","\u002Fv1\u002F{organizationId}\u002Fstudent\u002F{studentId}",19,{"operationId":476,"slug":477,"method":190,"path":473,"tag":62,"summary":201,"deprecated":134,"public":134,"permission":456,"scope":468,"order":478},"updateOrgStudent","update-org-student",20,{"operationId":480,"slug":481,"method":190,"path":482,"tag":62,"summary":204,"deprecated":134,"public":134,"permission":456,"scope":468,"order":483},"linkStudentSupervisor","link-student-supervisor","\u002Fv1\u002F{organizationId}\u002Fstudent\u002F{studentId}\u002Fsupervisor",21,{"tag":80,"slug":207,"description":485,"guide":81,"operations":486},"Links that sign one of your students into an organization’s panel. Each works once and expires two minutes after it is issued.",[487],{"operationId":488,"slug":489,"method":141,"path":490,"tag":80,"summary":210,"deprecated":134,"public":134,"permission":462,"scope":468,"order":491},"createSigninLink","create-signin-link","\u002Fv1\u002F{organizationId}\u002Fauth\u002Fsignin",22,{"tag":83,"slug":213,"description":493,"guide":84,"operations":494},"The exam categories and exams an organization runs, and the ones one of your students can apply to.",[495,501,507,512,517],{"operationId":496,"slug":497,"method":133,"path":498,"tag":83,"summary":216,"deprecated":134,"public":134,"permission":499,"scope":468,"order":500},"listExams","list-exams","\u002Fv1\u002F{organizationId}\u002Fexam","exam\u002Fread:$org:$ID",23,{"operationId":502,"slug":503,"method":133,"path":504,"tag":83,"summary":219,"deprecated":134,"public":134,"permission":505,"scope":468,"order":506},"listExamCategories","list-exam-categories","\u002Fv1\u002F{organizationId}\u002Fexam-category","exam-category\u002Fread:$org:$ID",24,{"operationId":508,"slug":509,"method":133,"path":510,"tag":83,"summary":222,"deprecated":134,"public":134,"permission":505,"scope":468,"order":511},"getExamCategory","get-exam-category","\u002Fv1\u002F{organizationId}\u002Fexam-category\u002F{categoryId}",25,{"operationId":513,"slug":514,"method":133,"path":515,"tag":83,"summary":225,"deprecated":134,"public":134,"permission":499,"scope":468,"order":516},"listAvailableExams","list-available-exams","\u002Fv1\u002F{organizationId}\u002Fexam\u002Favailable\u002F{studentId}",26,{"operationId":518,"slug":519,"method":133,"path":520,"tag":83,"summary":228,"deprecated":134,"public":134,"permission":499,"scope":468,"order":521},"getExam","get-exam","\u002Fv1\u002F{organizationId}\u002Fexam\u002F{examId}",27,{"tag":86,"slug":231,"description":523,"guide":87,"operations":524},"Entering your students for exams: creating, reading, moving and deleting their applications.",[525,531,536,541,546,551,556],{"operationId":526,"slug":527,"method":133,"path":528,"tag":86,"summary":234,"deprecated":134,"public":134,"permission":529,"scope":468,"order":530},"listApplications","list-applications","\u002Fv1\u002F{organizationId}\u002Fapplication","application\u002Fread:$org:$ID",28,{"operationId":532,"slug":533,"method":141,"path":528,"tag":86,"summary":237,"deprecated":134,"public":134,"permission":534,"scope":468,"order":535},"createApplication","create-application","application\u002Fcreate:$org:$ID",29,{"operationId":537,"slug":538,"method":133,"path":539,"tag":86,"summary":240,"deprecated":134,"public":134,"permission":529,"scope":468,"order":540},"listExamApplications","list-exam-applications","\u002Fv1\u002F{organizationId}\u002Fapplication\u002Fexam-applications\u002F{examId}",30,{"operationId":542,"slug":543,"method":133,"path":544,"tag":86,"summary":243,"deprecated":134,"public":134,"permission":529,"scope":468,"order":545},"listStudentApplications","list-student-applications","\u002Fv1\u002F{organizationId}\u002Fapplication\u002Fstudent-applications\u002F{studentId}",31,{"operationId":547,"slug":548,"method":133,"path":549,"tag":86,"summary":246,"deprecated":134,"public":134,"permission":529,"scope":468,"order":550},"getApplication","get-application","\u002Fv1\u002F{organizationId}\u002Fapplication\u002F{applicationId}",32,{"operationId":552,"slug":553,"method":190,"path":549,"tag":86,"summary":249,"deprecated":134,"public":134,"permission":554,"scope":468,"order":555},"moveApplication","move-application","application\u002Fupdate:$org:$ID",33,{"operationId":557,"slug":558,"method":254,"path":549,"tag":86,"summary":252,"deprecated":134,"public":134,"permission":559,"scope":468,"order":560},"deleteApplication","delete-application","application\u002Fdelete:$org:$ID",34,{"tag":256,"slug":257,"description":562,"guide":93,"operations":563},"Your students’ certificates and reports: listing them and downloading the files.",[564,570,575,581],{"operationId":565,"slug":566,"method":133,"path":567,"tag":256,"summary":260,"deprecated":134,"public":134,"permission":568,"scope":468,"order":569},"downloadCertificate","download-certificate","\u002Fv1\u002F{organizationId}\u002Fcertificate\u002Fdownload\u002F{certificateId}","certificate\u002Fread:$org:$ID",35,{"operationId":571,"slug":572,"method":133,"path":573,"tag":256,"summary":263,"deprecated":134,"public":134,"permission":568,"scope":468,"order":574},"listStudentCertificates","list-student-certificates","\u002Fv1\u002F{organizationId}\u002Fcertificate\u002F{userId}",36,{"operationId":576,"slug":577,"method":133,"path":578,"tag":256,"summary":266,"deprecated":134,"public":134,"permission":579,"scope":468,"order":580},"downloadReport","download-report","\u002Fv1\u002F{organizationId}\u002Freport\u002Fdownload\u002F{reportId}","report\u002Fread:$org:$ID",37,{"operationId":582,"slug":583,"method":133,"path":584,"tag":256,"summary":269,"deprecated":134,"public":134,"permission":579,"scope":468,"order":585},"listStudentReports","list-student-reports","\u002Fv1\u002F{organizationId}\u002Freport\u002F{userId}",38,{"tag":89,"slug":272,"description":587,"guide":90,"operations":588},"Online group challenges your students take part in: the challenges, which of your students can join, the groups they are in, each step and its files, what happened in a group, and submitting on your student’s behalf.",[589,595,600,605,610,615,621,626,631],{"operationId":590,"slug":591,"method":133,"path":592,"tag":89,"summary":275,"deprecated":134,"public":134,"permission":593,"scope":468,"order":594},"listGroupChallenges","list-group-challenges","\u002Fv1\u002F{organizationId}\u002Fgroup-challenge","group-challenge\u002Fread:$org:$ID",39,{"operationId":596,"slug":597,"method":133,"path":598,"tag":89,"summary":278,"deprecated":134,"public":134,"permission":593,"scope":468,"order":599},"getGroupChallenge","get-group-challenge","\u002Fv1\u002F{organizationId}\u002Fgroup-challenge\u002F{challengeId}",40,{"operationId":601,"slug":602,"method":133,"path":603,"tag":89,"summary":281,"deprecated":134,"public":134,"permission":593,"scope":468,"order":604},"listGroupChallengeGroups","list-group-challenge-groups","\u002Fv1\u002F{organizationId}\u002Fgroup-challenge\u002F{challengeId}\u002Fgroup",41,{"operationId":606,"slug":607,"method":133,"path":608,"tag":89,"summary":284,"deprecated":134,"public":134,"permission":593,"scope":468,"order":609},"getGroupChallengeGroup","get-group-challenge-group","\u002Fv1\u002F{organizationId}\u002Fgroup-challenge\u002F{challengeId}\u002Fgroup\u002F{groupId}",42,{"operationId":611,"slug":612,"method":133,"path":613,"tag":89,"summary":287,"deprecated":134,"public":134,"permission":593,"scope":468,"order":614},"listGroupChallengeActivity","list-group-challenge-activity","\u002Fv1\u002F{organizationId}\u002Fgroup-challenge\u002F{challengeId}\u002Fgroup\u002F{groupId}\u002Factivity",43,{"operationId":616,"slug":617,"method":141,"path":618,"tag":89,"summary":290,"deprecated":134,"public":134,"permission":619,"scope":468,"order":620},"submitGroupChallengeWork","submit-group-challenge-work","\u002Fv1\u002F{organizationId}\u002Fgroup-challenge\u002F{challengeId}\u002Fgroup\u002F{groupId}\u002Ffinal-submit","group-challenge\u002Fsubmit:$org:$ID",44,{"operationId":622,"slug":623,"method":141,"path":624,"tag":89,"summary":293,"deprecated":134,"public":134,"permission":619,"scope":468,"order":625},"submitGroupChallengeStep","submit-group-challenge-step","\u002Fv1\u002F{organizationId}\u002Fgroup-challenge\u002F{challengeId}\u002Fgroup\u002F{groupId}\u002Fstep\u002F{stepId}\u002Fsubmit",45,{"operationId":627,"slug":628,"method":133,"path":629,"tag":89,"summary":296,"deprecated":134,"public":134,"permission":593,"scope":468,"order":630},"listGroupChallengeStudents","list-group-challenge-students","\u002Fv1\u002F{organizationId}\u002Fgroup-challenge\u002F{challengeId}\u002Fstudent",46,{"operationId":632,"slug":633,"method":133,"path":634,"tag":89,"summary":299,"deprecated":134,"public":134,"permission":593,"scope":468,"order":635},"getGroupChallengeStudent","get-group-challenge-student","\u002Fv1\u002F{organizationId}\u002Fgroup-challenge\u002F{challengeId}\u002Fstudent\u002F{studentId}",47,{"operationId":606,"slug":607,"method":133,"path":608,"tag":89,"summary":284,"deprecated":134,"public":134,"permission":593,"scope":468,"order":609,"description":637,"permissions":638,"errors":639,"guide":365,"parameters":678,"requestBody":365,"responses":695,"successStatus":1145,"kind":1146,"paginated":134,"baseUrl":355,"tagDescription":587,"sandbox":364},"Reads one group that one of your students is an active member of, with each step, its state and its files. Steps appear once the teacher has confirmed the group (`finalized`).\n\n`canSubmit` on a step and `canFinalSubmit` on the group are the answers `submitGroupChallengeStep` and `submitGroupChallengeWork` would give right now, so read the group before you submit.\n\nOnly your own students are named. Every other person — the other members, the teacher, the organizers — is shown by role alone, with `studentId` and `name` set to `null`, and a file’s name only when one of your students uploaded it.",[593],[640,645,648,652,657,662,664,667,670,674],{"code":641,"message":642,"status":643,"when":644},"bad_request","Invalid value for 'challengeId': expected ObjectId.",400,"`challengeId` is not 24 hexadecimal digits.",{"code":641,"message":646,"status":643,"when":647},"Invalid value for 'groupId': expected ObjectId.","`groupId` is not 24 hexadecimal digits.",{"code":649,"status":650,"when":651},"unauthorized",401,"The token is missing or malformed, is not signed with your account’s `apiSecret`, breaks the `iat` and `exp` rules, has expired or been revoked, or its account is not active. All of these answer the same.",{"code":653,"message":654,"status":655,"when":656},"forbidden","Insufficient role permissions",403,"The token is valid, but no role on your account allows `group-challenge\u002Fread` on the organization in the path, or a role denies it.",{"code":658,"message":659,"status":660,"when":661},"not_found","Organization not found!",404,"`organizationId` is not the `_id` of an organization.",{"code":658,"status":660,"when":663},"Group challenges are not switched on for this organization. The answer is the one an unknown path gets; nothing was read.",{"code":658,"message":665,"status":660,"when":666},"Group challenge not found!","No group challenge of this organization has this id, or it is not published: a draft, archived or deleted challenge answers the same.",{"code":658,"message":668,"status":660,"when":669},"Group not found!","No group of this challenge has this id that one of your students is an active member of: a missing group, a deleted one and another account’s get the same answer.",{"code":671,"status":672,"when":673},"too_many_requests",429,"Your account has made more than 100 requests to this operation in the current 60-second window. Wait the seconds in `Retry-After` before sending again.",{"code":675,"status":676,"when":677},"internal_error",500,"Something failed on our side. Retry later, and quote `request_id` if it goes on.",[679,687,691],{"description":680,"example":681,"in":682,"name":683,"required":364,"schema":684},"The organization’s `_id`: 24 hexadecimal digits, as `listOrganizations` (`GET \u002Fv1\u002Forganization`) lists it.","64b7f0c2a1d3e4f5a6b7c8d9","path","organizationId",{"pattern":685,"type":686},"^[0-9a-f]{24}$","string",{"description":688,"in":682,"name":689,"required":364,"schema":690},"The group challenge’s `_id`, from `listGroupChallenges`.","challengeId",{"type":686},{"description":692,"in":682,"name":693,"required":364,"schema":694},"The group’s `_id`, from `listGroupChallengeGroups` or a student’s `group`.","groupId",{"type":686},{"200":696,"400":977,"401":1024,"403":1046,"404":1067,"429":1097,"500":1123},{"content":697,"description":965,"headers":966},{"application\u002Fjson":698},{"schema":699},{"allOf":700},[701,740],{"x-ref":702,"description":703,"properties":704,"required":737,"type":735},"#\u002Fcomponents\u002Fschemas\u002FSuccessEnvelope","How every successful JSON response is wrapped. `data` is the result, and each operation declares its shape; list operations add `pagination`. `GET \u002Fv1\u002Fapi-account\u002Fvalidate-me` is the one operation that answers without this envelope.",{"success":705,"message":709,"pagination":712},{"description":706,"enum":707,"example":364,"type":708},"Always `true` on a success.",[364],"boolean",{"description":710,"example":711,"type":686},"A sentence saying what happened, written for a person. Branch on the status and on `data`, not on this.","Request completed successfully.",{"allOf":713,"description":736},[714],{"x-ref":715,"description":716,"properties":717,"required":730,"type":735},"#\u002Fcomponents\u002Fschemas\u002FPaginationMeta","Where one page sits in the whole list.",{"page":718,"limit":721,"total":724,"totalPages":728},{"description":719,"example":367,"minimum":367,"type":720},"The page returned, counting from 1.","number",{"description":722,"example":478,"maximum":723,"minimum":367,"type":720},"Items per page: the `limit` you sent, 20 if you sent none, and never more than 100.",100,{"description":725,"example":726,"minimum":727,"type":720},"Items across every page.",57,0,{"description":729,"example":382,"minimum":727,"type":720},"Pages at this `limit`: `total \u002F limit`, rounded up.",[731,732,733,734],"page","limit","total","totalPages","object","On list operations only.",[738,739],"success","message",{"properties":741,"required":963,"type":735},{"message":742,"data":744},{"example":743,"type":686},"Group fetched successfully.",{"x-ref":745,"description":746,"properties":747,"required":949,"type":735},"#\u002Fcomponents\u002Fschemas\u002FGroupChallengeGroupResponse","A group one or more of your students are in, with its steps.",{"_id":748,"challengeId":751,"shortCode":754,"name":757,"displayName":759,"status":762,"gradeGroup":769,"memberCount":785,"yourStudents":787,"stepCount":816,"stepsSubmitted":818,"createdAt":820,"finalizedAt":822,"finalSubmittedAt":825,"finalSubmittedBy":827,"canFinalSubmit":853,"steps":855},{"description":749,"example":750,"type":686},"The group’s id: the `groupId` of the group operations.","6650a1b2c3d4e5f6a7b8c9ed",{"description":752,"example":753,"type":686},"The challenge it belongs to.","6650a1b2c3d4e5f6a7b8c9eb",{"description":755,"example":756,"type":686},"A six-character code for the group, unique in the organization.","7KQ2MX",{"description":758,"example":365,"nullable":364,"type":735},"The name the teacher gave it, or `null`.",{"description":760,"example":761,"type":686},"`name`, or \"Group\" and the short code when it has none.","Group 7KQ2MX",{"description":763,"enum":764,"example":767,"type":686},"`awaiting_payment` and `draft` while the teacher prepares it; `finalized` once confirmed, with its steps open one by one; `completed` once its work has been sent. New values may be added.",[765,766,767,768],"awaiting_payment","draft","finalized","completed",{"allOf":770,"description":784},[771],{"x-ref":772,"description":773,"properties":774,"required":781,"type":735},"#\u002Fcomponents\u002Fschemas\u002FGroupChallengeGradeGroupRefResponse","A grade group of the challenge, by id and name.",{"_id":775,"label":778},{"description":776,"example":777,"type":686},"The grade group’s id within the challenge.","6650a1b2c3d4e5f6a7b8c9ec",{"description":779,"example":780,"type":686},"Its name.","Group 7-8-9",[782,783],"_id","label","The grade group its members come from.",{"description":786,"example":382,"type":720},"How many students are in it, yours and others.",{"description":788,"items":789,"type":815},"Your students in it. The other members are counted in `memberCount` and not listed.",{"x-ref":790,"description":791,"properties":792,"required":809,"type":735},"#\u002Fcomponents\u002Fschemas\u002FGroupChallengeMemberResponse","One of your students in a group.",{"studentId":793,"firstName":796,"lastName":799,"gradeName":802,"addedAt":805},{"description":794,"example":795,"type":686},"The student’s `_id`, as `registerStudent` returned it.","6650a1b2c3d4e5f6a7b8c9d0",{"description":797,"example":798,"type":686},"Their first name when they joined the group.","Ada",{"description":800,"example":801,"type":686},"Their last name then.","Lovelace",{"description":803,"example":804,"nullable":364,"type":735},"Their grade’s name then.","8",{"description":806,"example":807,"format":808,"nullable":364,"type":686},"When the teacher added them.","2026-10-05T13:20:00.000Z","date-time",[810,811,812,813,814],"studentId","firstName","lastName","gradeName","addedAt","array",{"description":817,"example":382,"type":720},"How many steps the group works through.",{"description":819,"example":367,"type":720},"How many of them are submitted.",{"description":821,"example":807,"format":808,"nullable":364,"type":686},"When the teacher created it.",{"description":823,"example":824,"format":808,"nullable":364,"type":686},"When the teacher confirmed it, or `null`.","2026-10-12T08:15:00.000Z",{"description":826,"example":365,"format":808,"nullable":364,"type":686},"When its work was sent, or `null`.",{"allOf":828,"description":852,"nullable":364,"type":735},[829],{"x-ref":830,"description":831,"properties":832,"required":848,"type":735},"#\u002Fcomponents\u002Fschemas\u002FGroupChallengePersonResponse","A person in a group challenge. Only your own students are named: everyone else — other members, the teacher, the organizers, another partner — is their role and nothing more.",{"role":833,"studentId":841,"name":843,"yours":846},{"description":834,"enum":835,"example":836,"type":686},"`student`, `teacher`, `administrator` (the organizers), `partner` (an API account, acting for a student) or `system`. New values may be added.",[836,837,838,839,840],"student","teacher","administrator","partner","system",{"description":842,"example":795,"nullable":364,"type":735},"The student’s `_id`, only when they are yours; otherwise `null`.",{"description":844,"example":845,"nullable":364,"type":735},"Their name, only when they are yours; otherwise `null`.","Ada Lovelace",{"description":847,"example":364,"type":708},"Whether this is one of your students, or your account acting for one.",[849,810,850,851],"role","name","yours","Who sent the group’s work, or `null` while it has not been sent.",{"description":854,"example":134,"type":708},"Whether `submitGroupChallengeWork` would send the work now: every step is submitted and the challenge is open.",{"description":856,"items":857,"type":815},"The steps, in order, once the teacher has confirmed the group; empty before that.",{"x-ref":858,"description":859,"properties":860,"required":940,"type":735},"#\u002Fcomponents\u002Fschemas\u002FGroupChallengeGroupStepResponse","One step of a group, with its files.",{"_id":861,"order":864,"title":866,"state":869,"openedAt":875,"submittedAt":877,"submittedBy":880,"reopenCount":891,"canSubmit":893,"files":895},{"description":862,"example":863,"type":686},"The step’s id: the `stepId` `submitGroupChallengeStep` takes.","6650a1b2c3d4e5f6a7b8c9ee",{"description":865,"example":367,"type":720},"Its position, from 1.",{"description":867,"example":868,"type":686},"Its title.","Project proposal",{"description":870,"enum":871,"example":874,"type":686},"`locked` until the step before it is submitted, `open` while the group works on it, `submitted` once it is sent. New values may be added.",[872,873,874],"locked","open","submitted",{"description":876,"example":824,"format":808,"nullable":364,"type":686},"When it opened.",{"description":878,"example":879,"format":808,"nullable":364,"type":686},"When it was submitted, or `null`.","2026-10-20T16:02:11.000Z",{"allOf":881,"description":890,"nullable":364,"type":735},[882],{"x-ref":830,"description":831,"properties":883,"required":889,"type":735},{"role":884,"studentId":886,"name":887,"yours":888},{"description":834,"enum":885,"example":836,"type":686},[836,837,838,839,840],{"description":842,"example":795,"nullable":364,"type":735},{"description":844,"example":845,"nullable":364,"type":735},{"description":847,"example":364,"type":708},[849,810,850,851],"Who submitted it, or `null`. `partner` with `yours: true` is your account, acting for one of your students.",{"description":892,"example":727,"type":720},"How many times the organizers reopened it after a submit.",{"description":894,"example":134,"type":708},"Whether `submitGroupChallengeStep` would submit it now: it is open, it has a file, and the challenge is open.",{"description":896,"items":897,"type":815},"Its files, uploading, uploaded or submitted.",{"x-ref":898,"description":899,"properties":900,"required":933,"type":735},"#\u002Fcomponents\u002Fschemas\u002FGroupChallengeFileResponse","A file a member uploaded for a step.",{"_id":901,"status":904,"name":908,"fileType":911,"size":914,"uploadedBy":917,"completedAt":928,"submittedAt":931},{"description":902,"example":903,"type":686},"The file’s id.","6650a1b2c3d4e5f6a7b8c9ef",{"description":905,"enum":906,"example":874,"type":686},"`uploading` while the upload runs, `draft` once uploaded, `submitted` once its step is submitted. New values may be added.",[907,766,874],"uploading",{"description":909,"example":910,"nullable":364,"type":735},"The file’s name, only when one of your students uploaded it; otherwise `null`.","proposal.pdf",{"description":912,"example":913,"nullable":364,"type":735},"Its type, by extension.","pdf",{"description":915,"example":916,"nullable":364,"type":735},"Its size in bytes, once uploaded; `null` while uploading.",1048576,{"allOf":918,"description":927},[919],{"x-ref":830,"description":831,"properties":920,"required":926,"type":735},{"role":921,"studentId":923,"name":924,"yours":925},{"description":834,"enum":922,"example":836,"type":686},[836,837,838,839,840],{"description":842,"example":795,"nullable":364,"type":735},{"description":844,"example":845,"nullable":364,"type":735},{"description":847,"example":364,"type":708},[849,810,850,851],"Who uploaded it.",{"description":929,"example":930,"format":808,"nullable":364,"type":686},"When the upload finished.","2026-10-20T15:47:03.000Z",{"description":932,"example":879,"format":808,"nullable":364,"type":686},"When its step was submitted with it.",[782,934,850,935,936,937,938,939],"status","fileType","size","uploadedBy","completedAt","submittedAt",[782,941,942,943,944,939,945,946,947,948],"order","title","state","openedAt","submittedBy","reopenCount","canSubmit","files",[782,689,950,850,951,934,952,953,954,955,956,957,958,959,960,961,962],"shortCode","displayName","gradeGroup","memberCount","yourStudents","stepCount","stepsSubmitted","createdAt","finalizedAt","finalSubmittedAt","finalSubmittedBy","canFinalSubmit","steps",[964],"data","Success: `message` is \"Group fetched successfully.\".",{"X-RateLimit-Limit":967,"X-RateLimit-Remaining":971,"X-RateLimit-Reset":974},{"description":968,"schema":969},"Requests your account may make to this operation per window (100).",{"type":970},"integer",{"description":972,"schema":973},"Requests left in the current window.",{"type":970},{"description":975,"schema":976},"Seconds until the current window ends.",{"type":970},{"content":978,"description":1023},{"application\u002Fjson":979},{"examples":980,"schema":989},{"bad_request":981,"bad_request_2":986},{"summary":644,"value":982},{"error":983},{"code":641,"documentation_url":984,"message":642,"request_id":985},"https:\u002F\u002Fhub.main-team.org\u002Fapi\u002Ferrors#bad_request","0b5c6d0e-8f7a-4b1c-9d2e-3f4a5b6c7d8e",{"summary":647,"value":987},{"error":988},{"code":641,"documentation_url":984,"message":646,"request_id":985},{"x-ref":990,"description":991,"properties":992,"required":1021,"type":735},"#\u002Fcomponents\u002Fschemas\u002FErrorEnvelope","How every error response is wrapped.",{"error":993},{"x-ref":994,"description":995,"properties":996,"required":1017,"type":735},"#\u002Fcomponents\u002Fschemas\u002FErrorDetail","What went wrong.",{"code":997,"message":1006,"documentation_url":1009,"request_id":1013,"details":1015},{"description":998,"enum":999,"example":658,"type":686},"A stable machine code: branch on this. Each one is explained at `documentation_url`.",[1000,641,649,653,658,1001,1002,1003,1004,671,675,1005],"invalid_email","conflict","payload_too_large","unsupported_media_type","unprocessable_entity","service_unavailable",{"description":1007,"example":1008,"type":686},"Written for a person, and may change: never branch on it.","Not found!",{"description":1010,"example":1011,"format":1012,"type":686},"Where this code is explained.","https:\u002F\u002Fhub.main-team.org\u002Fapi\u002Ferrors#not_found","uri",{"description":1014,"example":985,"type":686},"This request’s id, also sent as the `X-Request-Id` response header: the one you sent, when it was acceptable, or else one the API made. Quote it when you report a problem.",{"additionalProperties":364,"description":1016,"type":735},"Present only where an operation says so, and then with the shape that operation documents — the rows it could not accept, say. Treat it as absent everywhere else, and ignore a `details` you do not recognise.",[1018,739,1019,1020],"code","documentation_url","request_id",[1022],"error","- `bad_request`: `challengeId` is not 24 hexadecimal digits.\n- `bad_request`: `groupId` is not 24 hexadecimal digits.",{"content":1025,"description":1045},{"application\u002Fjson":1026},{"examples":1027,"schema":1033},{"unauthorized":1028},{"summary":649,"value":1029},{"error":1030},{"code":649,"documentation_url":1031,"message":1032,"request_id":985},"https:\u002F\u002Fhub.main-team.org\u002Fapi\u002Ferrors#unauthorized","Authentication is required or the provided credentials are invalid.",{"x-ref":990,"description":991,"properties":1034,"required":1044,"type":735},{"error":1035},{"x-ref":994,"description":995,"properties":1036,"required":1043,"type":735},{"code":1037,"message":1039,"documentation_url":1040,"request_id":1041,"details":1042},{"description":998,"enum":1038,"example":658,"type":686},[1000,641,649,653,658,1001,1002,1003,1004,671,675,1005],{"description":1007,"example":1008,"type":686},{"description":1010,"example":1011,"format":1012,"type":686},{"description":1014,"example":985,"type":686},{"additionalProperties":364,"description":1016,"type":735},[1018,739,1019,1020],[1022],"`unauthorized`: The token is missing or malformed, is not signed with your account’s `apiSecret`, breaks the `iat` and `exp` rules, has expired or been revoked, or its account is not active. All of these answer the same.",{"content":1047,"description":1066},{"application\u002Fjson":1048},{"examples":1049,"schema":1054},{"forbidden":1050},{"summary":653,"value":1051},{"error":1052},{"code":653,"documentation_url":1053,"message":654,"request_id":985},"https:\u002F\u002Fhub.main-team.org\u002Fapi\u002Ferrors#forbidden",{"x-ref":990,"description":991,"properties":1055,"required":1065,"type":735},{"error":1056},{"x-ref":994,"description":995,"properties":1057,"required":1064,"type":735},{"code":1058,"message":1060,"documentation_url":1061,"request_id":1062,"details":1063},{"description":998,"enum":1059,"example":658,"type":686},[1000,641,649,653,658,1001,1002,1003,1004,671,675,1005],{"description":1007,"example":1008,"type":686},{"description":1010,"example":1011,"format":1012,"type":686},{"description":1014,"example":985,"type":686},{"additionalProperties":364,"description":1016,"type":735},[1018,739,1019,1020],[1022],"`forbidden`: The token is valid, but no role on your account allows `group-challenge\u002Fread` on the organization in the path, or a role denies it.",{"content":1068,"description":1096},{"application\u002Fjson":1069},{"examples":1070,"schema":1084},{"not_found":1071,"not_found_2":1074,"not_found_3":1078,"not_found_4":1081},{"summary":661,"value":1072},{"error":1073},{"code":658,"documentation_url":1011,"message":659,"request_id":985},{"summary":663,"value":1075},{"error":1076},{"code":658,"documentation_url":1011,"message":1077,"request_id":985},"The requested resource could not be found.",{"summary":666,"value":1079},{"error":1080},{"code":658,"documentation_url":1011,"message":665,"request_id":985},{"summary":669,"value":1082},{"error":1083},{"code":658,"documentation_url":1011,"message":668,"request_id":985},{"x-ref":990,"description":991,"properties":1085,"required":1095,"type":735},{"error":1086},{"x-ref":994,"description":995,"properties":1087,"required":1094,"type":735},{"code":1088,"message":1090,"documentation_url":1091,"request_id":1092,"details":1093},{"description":998,"enum":1089,"example":658,"type":686},[1000,641,649,653,658,1001,1002,1003,1004,671,675,1005],{"description":1007,"example":1008,"type":686},{"description":1010,"example":1011,"format":1012,"type":686},{"description":1014,"example":985,"type":686},{"additionalProperties":364,"description":1016,"type":735},[1018,739,1019,1020],[1022],"- `not_found`: `organizationId` is not the `_id` of an organization.\n- `not_found`: Group challenges are not switched on for this organization. The answer is the one an unknown path gets; nothing was read.\n- `not_found`: No group challenge of this organization has this id, or it is not published: a draft, archived or deleted challenge answers the same.\n- `not_found`: No group of this challenge has this id that one of your students is an active member of: a missing group, a deleted one and another account’s get the same answer.",{"content":1098,"description":1118,"headers":1119},{"application\u002Fjson":1099},{"examples":1100,"schema":1106},{"too_many_requests":1101},{"summary":671,"value":1102},{"error":1103},{"code":671,"documentation_url":1104,"message":1105,"request_id":985},"https:\u002F\u002Fhub.main-team.org\u002Fapi\u002Ferrors#too_many_requests","Too many requests to this operation. Wait the number of seconds in Retry-After, then try again.",{"x-ref":990,"description":991,"properties":1107,"required":1117,"type":735},{"error":1108},{"x-ref":994,"description":995,"properties":1109,"required":1116,"type":735},{"code":1110,"message":1112,"documentation_url":1113,"request_id":1114,"details":1115},{"description":998,"enum":1111,"example":658,"type":686},[1000,641,649,653,658,1001,1002,1003,1004,671,675,1005],{"description":1007,"example":1008,"type":686},{"description":1010,"example":1011,"format":1012,"type":686},{"description":1014,"example":985,"type":686},{"additionalProperties":364,"description":1016,"type":735},[1018,739,1019,1020],[1022],"`too_many_requests`: Your account has made more than 100 requests to this operation in the current 60-second window. Wait the seconds in `Retry-After` before sending again.",{"Retry-After":1120},{"description":1121,"schema":1122},"Seconds to wait before sending again; a request sent sooner is refused too.",{"type":970},{"content":1124,"description":1144},{"application\u002Fjson":1125},{"examples":1126,"schema":1132},{"internal_error":1127},{"summary":675,"value":1128},{"error":1129},{"code":675,"documentation_url":1130,"message":1131,"request_id":985},"https:\u002F\u002Fhub.main-team.org\u002Fapi\u002Ferrors#internal_error","An unexpected error occurred.",{"x-ref":990,"description":991,"properties":1133,"required":1143,"type":735},{"error":1134},{"x-ref":994,"description":995,"properties":1135,"required":1142,"type":735},{"code":1136,"message":1138,"documentation_url":1139,"request_id":1140,"details":1141},{"description":998,"enum":1137,"example":658,"type":686},[1000,641,649,653,658,1001,1002,1003,1004,671,675,1005],{"description":1007,"example":1008,"type":686},{"description":1010,"example":1011,"format":1012,"type":686},{"description":1014,"example":985,"type":686},{"additionalProperties":364,"description":1016,"type":735},[1018,739,1019,1020],[1022],"`internal_error`: Something failed on our side. Retry later, and quote `request_id` if it goes on.","200","envelope",{"path":26},{"id":1149,"title":284,"apiPath":608,"body":1150,"deprecated":134,"description":1679,"extension":1680,"meta":1681,"method":133,"navigation":364,"operationId":606,"order":1682,"path":285,"permission":593,"public":134,"seo":1683,"stem":1684,"summary":284,"tag":89,"__hash__":1685},"apiReference\u002Fapi\u002Freference\u002Fget-group-challenge-group.md",{"type":1151,"value":1152,"toc":1677},"minimark",[1153,1673],[1154,1155,1156,1206,1397],"api-code-group",{},[1157,1158,1164],"pre",{"className":1159,"code":1160,"filename":1161,"language":1162,"meta":1163,"style":1163},"language-bash shiki shiki-themes github-light-high-contrast github-dark-high-contrast","# $TOKEN: a short-lived token you minted with your API key and secret\ncurl -sS 'https:\u002F\u002Fapi.main-team.org\u002Fv1\u002F\u003CorganizationId>\u002Fgroup-challenge\u002F\u003CchallengeId>\u002Fgroup\u002F\u003CgroupId>' \\\n  -H \"Authorization: Bearer $TOKEN\"\n","curl","bash","",[1018,1165,1166,1174,1191],{"__ignoreMap":1163},[1167,1168,1170],"span",{"class":1169,"line":367},"line",[1167,1171,1173],{"class":1172},"sLBg1","# $TOKEN: a short-lived token you minted with your API key and secret\n",[1167,1175,1176,1179,1183,1187],{"class":1169,"line":377},[1167,1177,1161],{"class":1178},"soyes",[1167,1180,1182],{"class":1181},"s-5SL"," -sS",[1167,1184,1186],{"class":1185},"sT6z2"," 'https:\u002F\u002Fapi.main-team.org\u002Fv1\u002F\u003CorganizationId>\u002Fgroup-challenge\u002F\u003CchallengeId>\u002Fgroup\u002F\u003CgroupId>'",[1167,1188,1190],{"class":1189},"sHUrx"," \\\n",[1167,1192,1193,1196,1199,1203],{"class":1169,"line":382},[1167,1194,1195],{"class":1181},"  -H",[1167,1197,1198],{"class":1185}," \"Authorization: Bearer ",[1167,1200,1202],{"class":1201},"suds8","$TOKEN",[1167,1204,1205],{"class":1185},"\"\n",[1157,1207,1211],{"className":1208,"code":1209,"filename":308,"language":1210,"meta":1163,"style":1163},"language-js shiki shiki-themes github-light-high-contrast github-dark-high-contrast","const token = process.env.TOKEN; \u002F\u002F a short-lived token you minted with your API key and secret\n\nconst res = await fetch('https:\u002F\u002Fapi.main-team.org\u002Fv1\u002F\u003CorganizationId>\u002Fgroup-challenge\u002F\u003CchallengeId>\u002Fgroup\u002F\u003CgroupId>', {\n  headers: {\n    Authorization: `Bearer ${token}`,\n  },\n});\nconst body = await res.json();\nif (!res.ok) throw new Error(`${res.status} ${body.error.code}: ${body.error.message}`);\nconsole.log(body.data);\n","js",[1018,1212,1213,1236,1241,1266,1271,1288,1293,1298,1318,1386],{"__ignoreMap":1163},[1167,1214,1215,1218,1221,1224,1227,1230,1233],{"class":1169,"line":367},[1167,1216,1217],{"class":1189},"const",[1167,1219,1220],{"class":1181}," token",[1167,1222,1223],{"class":1189}," =",[1167,1225,1226],{"class":1201}," process.env.",[1167,1228,1229],{"class":1181},"TOKEN",[1167,1231,1232],{"class":1201},"; ",[1167,1234,1235],{"class":1172},"\u002F\u002F a short-lived token you minted with your API key and secret\n",[1167,1237,1238],{"class":1169,"line":377},[1167,1239,1240],{"emptyLinePlaceholder":364},"\n",[1167,1242,1243,1245,1248,1250,1253,1257,1260,1263],{"class":1169,"line":382},[1167,1244,1217],{"class":1189},[1167,1246,1247],{"class":1181}," res",[1167,1249,1223],{"class":1189},[1167,1251,1252],{"class":1189}," await",[1167,1254,1256],{"class":1255},"sKwhi"," fetch",[1167,1258,1259],{"class":1201},"(",[1167,1261,1262],{"class":1185},"'https:\u002F\u002Fapi.main-team.org\u002Fv1\u002F\u003CorganizationId>\u002Fgroup-challenge\u002F\u003CchallengeId>\u002Fgroup\u002F\u003CgroupId>'",[1167,1264,1265],{"class":1201},", {\n",[1167,1267,1268],{"class":1169,"line":391},[1167,1269,1270],{"class":1201},"  headers: {\n",[1167,1272,1273,1276,1279,1282,1285],{"class":1169,"line":396},[1167,1274,1275],{"class":1201},"    Authorization: ",[1167,1277,1278],{"class":1185},"`Bearer ${",[1167,1280,1281],{"class":1201},"token",[1167,1283,1284],{"class":1185},"}`",[1167,1286,1287],{"class":1201},",\n",[1167,1289,1290],{"class":1169,"line":402},[1167,1291,1292],{"class":1201},"  },\n",[1167,1294,1295],{"class":1169,"line":407},[1167,1296,1297],{"class":1201},"});\n",[1167,1299,1300,1302,1305,1307,1309,1312,1315],{"class":1169,"line":413},[1167,1301,1217],{"class":1189},[1167,1303,1304],{"class":1181}," body",[1167,1306,1223],{"class":1189},[1167,1308,1252],{"class":1189},[1167,1310,1311],{"class":1201}," res.",[1167,1313,1314],{"class":1255},"json",[1167,1316,1317],{"class":1201},"();\n",[1167,1319,1320,1323,1326,1329,1332,1335,1338,1341,1343,1346,1349,1352,1354,1357,1360,1362,1364,1366,1368,1371,1373,1375,1377,1379,1381,1383],{"class":1169,"line":418},[1167,1321,1322],{"class":1189},"if",[1167,1324,1325],{"class":1201}," (",[1167,1327,1328],{"class":1189},"!",[1167,1330,1331],{"class":1201},"res.ok) ",[1167,1333,1334],{"class":1189},"throw",[1167,1336,1337],{"class":1189}," new",[1167,1339,1340],{"class":1255}," Error",[1167,1342,1259],{"class":1201},[1167,1344,1345],{"class":1185},"`${",[1167,1347,1348],{"class":1201},"res",[1167,1350,1351],{"class":1185},".",[1167,1353,934],{"class":1201},[1167,1355,1356],{"class":1185},"} ${",[1167,1358,1359],{"class":1201},"body",[1167,1361,1351],{"class":1185},[1167,1363,1022],{"class":1201},[1167,1365,1351],{"class":1185},[1167,1367,1018],{"class":1201},[1167,1369,1370],{"class":1185},"}: ${",[1167,1372,1359],{"class":1201},[1167,1374,1351],{"class":1185},[1167,1376,1022],{"class":1201},[1167,1378,1351],{"class":1185},[1167,1380,739],{"class":1201},[1167,1382,1284],{"class":1185},[1167,1384,1385],{"class":1201},");\n",[1167,1387,1388,1391,1394],{"class":1169,"line":427},[1167,1389,1390],{"class":1201},"console.",[1167,1392,1393],{"class":1255},"log",[1167,1395,1396],{"class":1201},"(body.data);\n",[1157,1398,1402],{"className":1399,"code":1400,"filename":311,"language":1401,"meta":1163,"style":1163},"language-php shiki shiki-themes github-light-high-contrast github-dark-high-contrast","\u003C?php\n$token = getenv('TOKEN'); \u002F\u002F a short-lived token you minted with your API key and secret\n\n$ch = curl_init('https:\u002F\u002Fapi.main-team.org\u002Fv1\u002F\u003CorganizationId>\u002Fgroup-challenge\u002F\u003CchallengeId>\u002Fgroup\u002F\u003CgroupId>');\ncurl_setopt_array($ch, [\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . $token,\n    ],\n    CURLOPT_RETURNTRANSFER => true,\n]);\n$response = curl_exec($ch);\nif ($response === false) {\n    throw new RuntimeException(curl_error($ch));\n}\n$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);\n$body = json_decode($response, true);\nif ($status >= 400) {\n    $error = $body['error'];\n    throw new RuntimeException(\"$status {$error['code']}: {$error['message']}\");\n}\nprint_r($body['data']);\n","php",[1018,1403,1404,1412,1433,1437,1453,1461,1472,1483,1488,1500,1505,1518,1534,1552,1557,1575,1593,1608,1624,1656,1660],{"__ignoreMap":1163},[1167,1405,1406,1409],{"class":1169,"line":367},[1167,1407,1408],{"class":1189},"\u003C?",[1167,1410,1411],{"class":1181},"php\n",[1167,1413,1414,1417,1420,1423,1425,1428,1431],{"class":1169,"line":377},[1167,1415,1416],{"class":1201},"$token ",[1167,1418,1419],{"class":1189},"=",[1167,1421,1422],{"class":1181}," getenv",[1167,1424,1259],{"class":1201},[1167,1426,1427],{"class":1185},"'TOKEN'",[1167,1429,1430],{"class":1201},"); ",[1167,1432,1235],{"class":1172},[1167,1434,1435],{"class":1169,"line":382},[1167,1436,1240],{"emptyLinePlaceholder":364},[1167,1438,1439,1442,1444,1447,1449,1451],{"class":1169,"line":391},[1167,1440,1441],{"class":1201},"$ch ",[1167,1443,1419],{"class":1189},[1167,1445,1446],{"class":1181}," curl_init",[1167,1448,1259],{"class":1201},[1167,1450,1262],{"class":1185},[1167,1452,1385],{"class":1201},[1167,1454,1455,1458],{"class":1169,"line":396},[1167,1456,1457],{"class":1181},"curl_setopt_array",[1167,1459,1460],{"class":1201},"($ch, [\n",[1167,1462,1463,1466,1469],{"class":1169,"line":402},[1167,1464,1465],{"class":1181},"    CURLOPT_HTTPHEADER",[1167,1467,1468],{"class":1189}," =>",[1167,1470,1471],{"class":1201}," [\n",[1167,1473,1474,1477,1480],{"class":1169,"line":407},[1167,1475,1476],{"class":1185},"        'Authorization: Bearer '",[1167,1478,1479],{"class":1189}," .",[1167,1481,1482],{"class":1201}," $token,\n",[1167,1484,1485],{"class":1169,"line":413},[1167,1486,1487],{"class":1201},"    ],\n",[1167,1489,1490,1493,1495,1498],{"class":1169,"line":418},[1167,1491,1492],{"class":1181},"    CURLOPT_RETURNTRANSFER",[1167,1494,1468],{"class":1189},[1167,1496,1497],{"class":1181}," true",[1167,1499,1287],{"class":1201},[1167,1501,1502],{"class":1169,"line":427},[1167,1503,1504],{"class":1201},"]);\n",[1167,1506,1507,1510,1512,1515],{"class":1169,"line":432},[1167,1508,1509],{"class":1201},"$response ",[1167,1511,1419],{"class":1189},[1167,1513,1514],{"class":1181}," curl_exec",[1167,1516,1517],{"class":1201},"($ch);\n",[1167,1519,1520,1522,1525,1528,1531],{"class":1169,"line":437},[1167,1521,1322],{"class":1189},[1167,1523,1524],{"class":1201}," ($response ",[1167,1526,1527],{"class":1189},"===",[1167,1529,1530],{"class":1181}," false",[1167,1532,1533],{"class":1201},") {\n",[1167,1535,1536,1539,1541,1544,1546,1549],{"class":1169,"line":442},[1167,1537,1538],{"class":1189},"    throw",[1167,1540,1337],{"class":1189},[1167,1542,1543],{"class":1181}," RuntimeException",[1167,1545,1259],{"class":1201},[1167,1547,1548],{"class":1181},"curl_error",[1167,1550,1551],{"class":1201},"($ch));\n",[1167,1553,1554],{"class":1169,"line":447},[1167,1555,1556],{"class":1201},"}\n",[1167,1558,1559,1562,1564,1567,1570,1573],{"class":1169,"line":452},[1167,1560,1561],{"class":1201},"$status ",[1167,1563,1419],{"class":1189},[1167,1565,1566],{"class":1181}," curl_getinfo",[1167,1568,1569],{"class":1201},"($ch, ",[1167,1571,1572],{"class":1181},"CURLINFO_RESPONSE_CODE",[1167,1574,1385],{"class":1201},[1167,1576,1577,1580,1582,1585,1588,1591],{"class":1169,"line":457},[1167,1578,1579],{"class":1201},"$body ",[1167,1581,1419],{"class":1189},[1167,1583,1584],{"class":1181}," json_decode",[1167,1586,1587],{"class":1201},"($response, ",[1167,1589,1590],{"class":1181},"true",[1167,1592,1385],{"class":1201},[1167,1594,1595,1597,1600,1603,1606],{"class":1169,"line":463},[1167,1596,1322],{"class":1189},[1167,1598,1599],{"class":1201}," ($status ",[1167,1601,1602],{"class":1189},">=",[1167,1604,1605],{"class":1181}," 400",[1167,1607,1533],{"class":1201},[1167,1609,1610,1613,1615,1618,1621],{"class":1169,"line":469},[1167,1611,1612],{"class":1201},"    $error ",[1167,1614,1419],{"class":1189},[1167,1616,1617],{"class":1201}," $body[",[1167,1619,1620],{"class":1185},"'error'",[1167,1622,1623],{"class":1201},"];\n",[1167,1625,1626,1628,1630,1632,1634,1637,1640,1643,1646,1649,1651,1654],{"class":1169,"line":474},[1167,1627,1538],{"class":1189},[1167,1629,1337],{"class":1189},[1167,1631,1543],{"class":1181},[1167,1633,1259],{"class":1201},[1167,1635,1636],{"class":1185},"\"",[1167,1638,1639],{"class":1201},"$status",[1167,1641,1642],{"class":1185}," {",[1167,1644,1645],{"class":1201},"$error",[1167,1647,1648],{"class":1185},"['code']}: {",[1167,1650,1645],{"class":1201},[1167,1652,1653],{"class":1185},"['message']}\"",[1167,1655,1385],{"class":1201},[1167,1657,1658],{"class":1169,"line":478},[1167,1659,1556],{"class":1201},[1167,1661,1662,1665,1668,1671],{"class":1169,"line":483},[1167,1663,1664],{"class":1181},"print_r",[1167,1666,1667],{"class":1201},"($body[",[1167,1669,1670],{"class":1185},"'data'",[1167,1672,1504],{"class":1201},[1674,1675,1676],"style",{},"html pre.shiki code .sLBg1, html code.shiki .sLBg1{--shiki-default:#66707B;--shiki-dark:#BDC4CC}html pre.shiki code .soyes, html code.shiki .soyes{--shiki-default:#702C00;--shiki-dark:#FFB757}html pre.shiki code .s-5SL, html code.shiki .s-5SL{--shiki-default:#023B95;--shiki-dark:#91CBFF}html pre.shiki code .sT6z2, html code.shiki .sT6z2{--shiki-default:#032563;--shiki-dark:#ADDCFF}html pre.shiki code .sHUrx, html code.shiki .sHUrx{--shiki-default:#A0111F;--shiki-dark:#FF9492}html pre.shiki code .suds8, html code.shiki .suds8{--shiki-default:#0E1116;--shiki-dark:#F0F3F6}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sKwhi, html code.shiki .sKwhi{--shiki-default:#622CBC;--shiki-dark:#DBB7FF}",{"title":1163,"searchDepth":377,"depth":382,"links":1678},[],"Reads one group that one of your students is an active member of, with each step, its state and its files.","md",{},"42",{"title":284,"description":1679},"api\u002Freference\u002Fget-group-challenge-group","bBD6fUw6ymknQyTxYn5pf1gR8m12gF1Dihg1nQx0RSs",1791554613405]