[{"data":1,"prerenderedAt":629},["ShallowReactive",2],{"page-/docs/api/permissions":3},{"id":4,"title":5,"body":6,"date":618,"description":195,"extension":619,"headline":620,"hideToc":621,"meta":622,"navigation":623,"path":624,"seo":625,"stem":626,"version":627,"__hash__":628},"content/docs/api/permissions.md","Permissions",{"type":7,"value":8,"toc":611},"minimark",[9,46,51,54,111,116,169,175,179,188,592,596,599,607],[10,11,17],"docs-alert",{"className":12,"color":14,"icon":15,"title":16},[13],"mb-6","primary","i-ph-info-duotone","Teams have been replaced",[18,19,20,21,25,26,29,30,33,34,37,38,29,42,45],"p",{},"Teams were removed on 2026-06-30. Datasets no longer have a ",[22,23,24],"code",{},"team"," field, and the ",[22,27,28],{},"/api/v3/teams"," and ",[22,31,32],{},"/api/v3/team"," endpoints no longer exist.\n",[35,36],"br",{},"\nAccess is now controlled by ",[39,40,41],"strong",{},"groups",[39,43,44],{},"permissions",", which are managed through the web interface.",[47,48,50],"h2",{"id":49},"how-access-works","How access works",[18,52,53],{},"Every user has a set of site-wide capabilities, plus any number of grants on individual objects.",[55,56,57,68,81,106],"ul",{},[58,59,60,63,64,67],"li",{},[39,61,62],{},"Administrators"," (",[22,65,66],{},"admin: true",") can do everything.",[58,69,70,63,73,76,77,80],{},[39,71,72],{},"Dataset managers",[22,74,75],{},"manageDatasets: true",") hold the ",[22,78,79],{},"editor"," role on every dataset on the site, so they can read, create, edit and delete any dataset.",[58,82,83,86,87,90,91],{},[39,84,85],{},"Groups"," are named sets of users, indexed by a 5-character ID, eg. ",[22,88,89],{},"ab12x",".\n",[55,92,93,103],{},[58,94,95,96,99,100,102],{},"A group may be flagged ",[22,97,98],{},"canCreateDatasets",", which lets its members create new datasets. A member who creates a dataset is automatically granted the ",[22,101,79],{}," role on it.",[58,104,105],{},"Groups can be granted a role on a dataset. Every member inherits that role.",[58,107,108,110],{},[39,109,5],{}," are grants of a role on a single dataset, to either a user or a group.",[112,113,115],"h3",{"id":114},"roles","Roles",[117,118,119,132],"table",{},[120,121,122],"thead",{},[123,124,125,129],"tr",{},[126,127,128],"th",{},"Role",[126,130,131],{},"Can do",[133,134,135,146,160],"tbody",{},[123,136,137,143],{},[138,139,140],"td",{},[22,141,142],{},"reader",[138,144,145],{},"View the dataset, even if it is private or archived.",[123,147,148,153],{},[138,149,150],{},[22,151,152],{},"uploader",[138,154,155,156,159],{},"Also add, replace and remove files and links, and set ",[22,157,158],{},"nextReviewDate",". Other metadata is locked.",[123,161,162,166],{},[138,163,164],{},[22,165,79],{},[138,167,168],{},"Edit all metadata, manage files, and delete the dataset.",[18,170,171,172,174],{},"Public datasets are readable by everyone, so ",[22,173,142],{}," grants only matter for private and archived datasets.",[47,176,178],{"id":177},"checking-your-own-access","Checking your own access",[18,180,181,182,187],{},"The ",[183,184,186],"a",{"href":185},"/docs/api/whoami","whoami"," endpoint returns your capabilities, your groups, and every grant that applies to you.",[189,190,196],"pre",{"className":191,"code":192,"filename":193,"language":194,"meta":195,"style":195},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"id\": 382,\n  \"admin\": false,\n  \"manageDatasets\": false,\n  \"groups\": {\n    \"59m9r\": {\n      \"id\": \"59m9r\",\n      \"title\": \"Health Intelligence\",\n      \"canCreateDatasets\": true,\n      \"permit\": {\n        \"dataset\": { \"20abc\": { \"id\": \"20abc\", \"role\": \"editor\" } },\n        \"webpage\": {},\n        \"blogpost\": {}\n      }\n    }\n  },\n  \"permit\": {\n    \"dataset\": { \"444xy\": { \"id\": \"444xy\", \"role\": \"uploader\" } },\n    \"webpage\": {},\n    \"blogpost\": {}\n  }\n  // [...]\n}\n","/api/v3/whoami","json","",[22,197,198,207,230,245,259,273,289,311,332,346,360,428,443,458,464,470,476,489,547,560,573,579,586],{"__ignoreMap":195},[199,200,203],"span",{"class":201,"line":202},"line",1,[199,204,206],{"class":205},"sMK4o","{\n",[199,208,210,213,217,220,223,227],{"class":201,"line":209},2,[199,211,212],{"class":205},"  \"",[199,214,216],{"class":215},"spNyl","id",[199,218,219],{"class":205},"\"",[199,221,222],{"class":205},":",[199,224,226],{"class":225},"sbssI"," 382",[199,228,229],{"class":205},",\n",[199,231,233,235,238,240,242],{"class":201,"line":232},3,[199,234,212],{"class":205},[199,236,237],{"class":215},"admin",[199,239,219],{"class":205},[199,241,222],{"class":205},[199,243,244],{"class":205}," false,\n",[199,246,248,250,253,255,257],{"class":201,"line":247},4,[199,249,212],{"class":205},[199,251,252],{"class":215},"manageDatasets",[199,254,219],{"class":205},[199,256,222],{"class":205},[199,258,244],{"class":205},[199,260,262,264,266,268,270],{"class":201,"line":261},5,[199,263,212],{"class":205},[199,265,41],{"class":215},[199,267,219],{"class":205},[199,269,222],{"class":205},[199,271,272],{"class":205}," {\n",[199,274,276,279,283,285,287],{"class":201,"line":275},6,[199,277,278],{"class":205},"    \"",[199,280,282],{"class":281},"sBMFI","59m9r",[199,284,219],{"class":205},[199,286,222],{"class":205},[199,288,272],{"class":205},[199,290,292,295,297,299,301,304,307,309],{"class":201,"line":291},7,[199,293,294],{"class":205},"      \"",[199,296,216],{"class":225},[199,298,219],{"class":205},[199,300,222],{"class":205},[199,302,303],{"class":205}," \"",[199,305,282],{"class":306},"sfazB",[199,308,219],{"class":205},[199,310,229],{"class":205},[199,312,314,316,319,321,323,325,328,330],{"class":201,"line":313},8,[199,315,294],{"class":205},[199,317,318],{"class":225},"title",[199,320,219],{"class":205},[199,322,222],{"class":205},[199,324,303],{"class":205},[199,326,327],{"class":306},"Health Intelligence",[199,329,219],{"class":205},[199,331,229],{"class":205},[199,333,335,337,339,341,343],{"class":201,"line":334},9,[199,336,294],{"class":205},[199,338,98],{"class":225},[199,340,219],{"class":205},[199,342,222],{"class":205},[199,344,345],{"class":205}," true,\n",[199,347,349,351,354,356,358],{"class":201,"line":348},10,[199,350,294],{"class":205},[199,352,353],{"class":225},"permit",[199,355,219],{"class":205},[199,357,222],{"class":205},[199,359,272],{"class":205},[199,361,363,366,370,372,374,377,379,383,385,387,389,391,394,396,398,400,402,404,407,409,412,414,416,418,420,422,425],{"class":201,"line":362},11,[199,364,365],{"class":205},"        \"",[199,367,369],{"class":368},"swJcz","dataset",[199,371,219],{"class":205},[199,373,222],{"class":205},[199,375,376],{"class":205}," {",[199,378,303],{"class":205},[199,380,382],{"class":381},"su27w","20abc",[199,384,219],{"class":205},[199,386,222],{"class":205},[199,388,376],{"class":205},[199,390,303],{"class":205},[199,392,216],{"class":393},"s2Zo4",[199,395,219],{"class":205},[199,397,222],{"class":205},[199,399,303],{"class":205},[199,401,382],{"class":306},[199,403,219],{"class":205},[199,405,406],{"class":205},",",[199,408,303],{"class":205},[199,410,411],{"class":393},"role",[199,413,219],{"class":205},[199,415,222],{"class":205},[199,417,303],{"class":205},[199,419,79],{"class":306},[199,421,219],{"class":205},[199,423,424],{"class":205}," }",[199,426,427],{"class":205}," },\n",[199,429,431,433,436,438,440],{"class":201,"line":430},12,[199,432,365],{"class":205},[199,434,435],{"class":368},"webpage",[199,437,219],{"class":205},[199,439,222],{"class":205},[199,441,442],{"class":205}," {},\n",[199,444,446,448,451,453,455],{"class":201,"line":445},13,[199,447,365],{"class":205},[199,449,450],{"class":368},"blogpost",[199,452,219],{"class":205},[199,454,222],{"class":205},[199,456,457],{"class":205}," {}\n",[199,459,461],{"class":201,"line":460},14,[199,462,463],{"class":205},"      }\n",[199,465,467],{"class":201,"line":466},15,[199,468,469],{"class":205},"    }\n",[199,471,473],{"class":201,"line":472},16,[199,474,475],{"class":205},"  },\n",[199,477,479,481,483,485,487],{"class":201,"line":478},17,[199,480,212],{"class":205},[199,482,353],{"class":215},[199,484,219],{"class":205},[199,486,222],{"class":205},[199,488,272],{"class":205},[199,490,492,494,496,498,500,502,504,507,509,511,513,515,517,519,521,523,525,527,529,531,533,535,537,539,541,543,545],{"class":201,"line":491},18,[199,493,278],{"class":205},[199,495,369],{"class":281},[199,497,219],{"class":205},[199,499,222],{"class":205},[199,501,376],{"class":205},[199,503,303],{"class":205},[199,505,506],{"class":225},"444xy",[199,508,219],{"class":205},[199,510,222],{"class":205},[199,512,376],{"class":205},[199,514,303],{"class":205},[199,516,216],{"class":368},[199,518,219],{"class":205},[199,520,222],{"class":205},[199,522,303],{"class":205},[199,524,506],{"class":306},[199,526,219],{"class":205},[199,528,406],{"class":205},[199,530,303],{"class":205},[199,532,411],{"class":368},[199,534,219],{"class":205},[199,536,222],{"class":205},[199,538,303],{"class":205},[199,540,152],{"class":306},[199,542,219],{"class":205},[199,544,424],{"class":205},[199,546,427],{"class":205},[199,548,550,552,554,556,558],{"class":201,"line":549},19,[199,551,278],{"class":205},[199,553,435],{"class":281},[199,555,219],{"class":205},[199,557,222],{"class":205},[199,559,442],{"class":205},[199,561,563,565,567,569,571],{"class":201,"line":562},20,[199,564,278],{"class":205},[199,566,450],{"class":281},[199,568,219],{"class":205},[199,570,222],{"class":205},[199,572,457],{"class":205},[199,574,576],{"class":201,"line":575},21,[199,577,578],{"class":205},"  }\n",[199,580,582],{"class":201,"line":581},22,[199,583,585],{"class":584},"sHwdD","  // [...]\n",[199,587,589],{"class":201,"line":588},23,[199,590,591],{"class":205},"}\n",[47,593,595],{"id":594},"managing-permissions","Managing permissions",[18,597,598],{},"Groups and permissions are managed by site administrators and dataset managers through the web interface. There is currently no public API for creating groups or granting permissions.",[18,600,601,602,606],{},"If you were previously using the teams API to automate this, please ",[183,603,605],{"href":604},"mailto:support@datapress.com","contact support",".",[608,609,610],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .su27w, html code.shiki .su27w{--shiki-light:#916B53;--shiki-default:#916B53;--shiki-dark:#916B53}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}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);}",{"title":195,"searchDepth":209,"depth":209,"links":612},[613,616,617],{"id":49,"depth":209,"text":50,"children":614},[615],{"id":114,"depth":232,"text":115},{"id":177,"depth":209,"text":178},{"id":594,"depth":209,"text":595},"2026-08-17","md","API Reference",false,{},true,"/docs/api/permissions",{"title":5,"description":195},"docs/api/permissions","5.0","PbJxA-oUdoF_SDGzusuTtm6B2Y0u2Y_6GRQKyKvMzRs",1787042523009]