[{"data":1,"prerenderedAt":1111},["ShallowReactive",2],{"navigation_docs_en":3,"-en-integration-api-reference-groups-access":427,"-en-integration-api-reference-groups-access-surround":1106},[4,31,117,188,238,271,310,369,378],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":30},"Getting started","i-hugeicons-rocket-01","\u002Fen\u002Fgetting-started","en\u002F01.getting-started",[10,15,20,25],{"title":11,"path":12,"stem":13,"icon":14},"What is DDM?","\u002Fen\u002Fgetting-started\u002Fwhat-is-ddm","en\u002F01.getting-started\u002F01.what-is-ddm","i-hugeicons-information-circle",{"title":16,"path":17,"stem":18,"icon":19},"Account and sign-in","\u002Fen\u002Fgetting-started\u002Fsign-in","en\u002F01.getting-started\u002F02.sign-in","i-hugeicons-key-01",{"title":21,"path":22,"stem":23,"icon":24},"AI in DDM","\u002Fen\u002Fgetting-started\u002Fai-in-ddm","en\u002F01.getting-started\u002F03.ai-in-ddm","i-hugeicons-ai-magic",{"title":26,"path":27,"stem":28,"icon":29},"System status","\u002Fen\u002Fgetting-started\u002Fsystem-status","en\u002F01.getting-started\u002F04.system-status","i-hugeicons-activity-03",false,{"title":32,"icon":33,"path":34,"stem":35,"children":36,"page":30},"CMS","i-hugeicons-dashboard-square-01","\u002Fen\u002Fcms","en\u002F02.cms",[37,42,47,52,57,62,67,72,77,82,87,92,97,102,107,112],{"title":38,"path":39,"stem":40,"icon":41},"The CMS at a glance","\u002Fen\u002Fcms\u002Foverview","en\u002F02.cms\u002F01.overview","i-hugeicons-compass-01",{"title":43,"path":44,"stem":45,"icon":46},"Uploading documents","\u002Fen\u002Fcms\u002Fupload","en\u002F02.cms\u002F02.upload","i-hugeicons-upload-01",{"title":48,"path":49,"stem":50,"icon":51},"Categories","\u002Fen\u002Fcms\u002Fcategories","en\u002F02.cms\u002F03.categories","i-hugeicons-folder-tree",{"title":53,"path":54,"stem":55,"icon":56},"Editing documents","\u002Fen\u002Fcms\u002Fdocuments","en\u002F02.cms\u002F04.documents","i-hugeicons-file-edit",{"title":58,"path":59,"stem":60,"icon":61},"Searching and filtering","\u002Fen\u002Fcms\u002Fsearch-and-filters","en\u002F02.cms\u002F05.search-and-filters","i-hugeicons-search-01",{"title":63,"path":64,"stem":65,"icon":66},"Groups and permissions","\u002Fen\u002Fcms\u002Fgroups-and-permissions","en\u002F02.cms\u002F06.groups-and-permissions","i-hugeicons-user-multiple",{"title":68,"path":69,"stem":70,"icon":71},"Users","\u002Fen\u002Fcms\u002Fusers","en\u002F02.cms\u002F07.users","i-hugeicons-user-add-01",{"title":73,"path":74,"stem":75,"icon":76},"Approvals","\u002Fen\u002Fcms\u002Fapprovals","en\u002F02.cms\u002F08.approvals","i-hugeicons-checkmark-badge-01",{"title":78,"path":79,"stem":80,"icon":81},"Markets and translations","\u002Fen\u002Fcms\u002Fmarkets-and-translations","en\u002F02.cms\u002F09.markets-and-translations","i-hugeicons-globe-02",{"title":83,"path":84,"stem":85,"icon":86},"Note templates","\u002Fen\u002Fcms\u002Fnote-templates","en\u002F02.cms\u002F10.note-templates","i-hugeicons-layout-01",{"title":88,"path":89,"stem":90,"icon":91},"Usage and audit log","\u002Fen\u002Fcms\u002Fusage-and-audit","en\u002F02.cms\u002F11.usage-and-audit","i-hugeicons-chart-column",{"title":93,"path":94,"stem":95,"icon":96},"AI assistant","\u002Fen\u002Fcms\u002Fassistant","en\u002F02.cms\u002F12.assistant","i-hugeicons-sparkles",{"title":98,"path":99,"stem":100,"icon":101},"Settings","\u002Fen\u002Fcms\u002Fsettings","en\u002F02.cms\u002F13.settings","i-hugeicons-settings-02",{"title":103,"path":104,"stem":105,"icon":106},"Plans","\u002Fen\u002Fcms\u002Fplans","en\u002F02.cms\u002F14.plans","i-hugeicons-package",{"title":108,"path":109,"stem":110,"icon":111},"Feature requests","\u002Fen\u002Fcms\u002Ffeature-requests","en\u002F02.cms\u002F15.feature-requests","i-hugeicons-idea-01",{"title":113,"path":114,"stem":115,"icon":116},"Report a bug","\u002Fen\u002Fcms\u002Fbug-reports","en\u002F02.cms\u002F16.bug-reports","i-hugeicons-bug-01",{"title":118,"icon":119,"path":120,"stem":121,"children":122,"page":30},"App","i-hugeicons-smart-phone-01","\u002Fen\u002Fapp","en\u002F03.app",[123,128,133,138,143,147,152,157,162,167,170,173,176,179,184],{"title":124,"path":125,"stem":126,"icon":127},"Signing in and finding your way","\u002Fen\u002Fapp\u002Foverview","en\u002F03.app\u002F01.overview","i-hugeicons-login-03",{"title":129,"path":130,"stem":131,"icon":132},"Tabs and split view","\u002Fen\u002Fapp\u002Ftabs","en\u002F03.app\u002F02.tabs","i-hugeicons-layout-2-column",{"title":134,"path":135,"stem":136,"icon":137},"Finding and reading documents","\u002Fen\u002Fapp\u002Fdocuments","en\u002F03.app\u002F03.documents","i-hugeicons-file-01",{"title":139,"path":140,"stem":141,"icon":142},"Favorites","\u002Fen\u002Fapp\u002Ffavorites","en\u002F03.app\u002F04.favorites","i-hugeicons-favourite",{"title":144,"path":145,"stem":146,"icon":61},"Searching","\u002Fen\u002Fapp\u002Fsearch","en\u002F03.app\u002F05.search",{"title":148,"path":149,"stem":150,"icon":151},"Notes","\u002Fen\u002Fapp\u002Fnotes","en\u002F03.app\u002F06.notes","i-hugeicons-note-edit",{"title":153,"path":154,"stem":155,"icon":156},"Calendar and appointments","\u002Fen\u002Fapp\u002Fcalendar","en\u002F03.app\u002F07.calendar","i-hugeicons-calendar-03",{"title":158,"path":159,"stem":160,"icon":161},"Sending to customers","\u002Fen\u002Fapp\u002Foutbox","en\u002F03.app\u002F08.outbox","i-hugeicons-sent",{"title":163,"path":164,"stem":165,"icon":166},"Working offline","\u002Fen\u002Fapp\u002Foffline","en\u002F03.app\u002F09.offline","i-hugeicons-wifi-off-01",{"title":93,"path":168,"stem":169,"icon":96},"\u002Fen\u002Fapp\u002Fassistant","en\u002F03.app\u002F10.assistant",{"title":98,"path":171,"stem":172,"icon":101},"\u002Fen\u002Fapp\u002Fsettings","en\u002F03.app\u002F11.settings",{"title":108,"path":174,"stem":175,"icon":111},"\u002Fen\u002Fapp\u002Ffeature-requests","en\u002F03.app\u002F12.feature-requests",{"title":113,"path":177,"stem":178,"icon":116},"\u002Fen\u002Fapp\u002Fbug-reports","en\u002F03.app\u002F13.bug-reports",{"title":180,"path":181,"stem":182,"icon":183},"Desktop app","\u002Fen\u002Fapp\u002Fdesktop-app","en\u002F03.app\u002F14.desktop-app","i-hugeicons-computer",{"title":185,"path":186,"stem":187,"icon":119},"Mobile app","\u002Fen\u002Fapp\u002Fmobile-app","en\u002F03.app\u002F15.mobile-app",{"title":189,"icon":190,"path":191,"stem":192,"children":193,"page":30},"Sign-in & directories","i-hugeicons-security-check","\u002Fen\u002Fsign-in-and-directories","en\u002F04.sign-in-and-directories",[194,198,202,207,212,217,222,226,230,234],{"title":195,"path":196,"stem":197,"icon":19},"Sign-in methods","\u002Fen\u002Fsign-in-and-directories\u002Fsign-in-methods","en\u002F04.sign-in-and-directories\u002F01.sign-in-methods",{"title":199,"path":200,"stem":201,"icon":190},"Single sign-on","\u002Fen\u002Fsign-in-and-directories\u002Fsingle-sign-on","en\u002F04.sign-in-and-directories\u002F02.single-sign-on",{"title":203,"path":204,"stem":205,"icon":206},"Directory services (LDAP)","\u002Fen\u002Fsign-in-and-directories\u002Fdirectory-services","en\u002F04.sign-in-and-directories\u002F03.directory-services","i-hugeicons-hierarchy",{"title":208,"path":209,"stem":210,"icon":211},"Synchronisation and sign-in","\u002Fen\u002Fsign-in-and-directories\u002Fdirectory-sync","en\u002F04.sign-in-and-directories\u002F04.directory-sync","i-hugeicons-refresh",{"title":213,"path":214,"stem":215,"icon":216},"Microsoft Entra ID","\u002Fen\u002Fsign-in-and-directories\u002Fmicrosoft-entra-id","en\u002F04.sign-in-and-directories\u002F05.microsoft-entra-id","i-hugeicons-building-03",{"title":218,"path":219,"stem":220,"icon":221},"Okta","\u002Fen\u002Fsign-in-and-directories\u002Fokta","en\u002F04.sign-in-and-directories\u002F06.okta","i-hugeicons-finger-print",{"title":223,"path":224,"stem":225,"icon":81},"Google Workspace","\u002Fen\u002Fsign-in-and-directories\u002Fgoogle-workspace","en\u002F04.sign-in-and-directories\u002F07.google-workspace",{"title":227,"path":228,"stem":229,"icon":119},"Two-factor authentication","\u002Fen\u002Fsign-in-and-directories\u002Ftwo-factor-authentication","en\u002F04.sign-in-and-directories\u002F08.two-factor-authentication",{"title":231,"path":232,"stem":233,"icon":221},"Passkeys","\u002Fen\u002Fsign-in-and-directories\u002Fpasskeys","en\u002F04.sign-in-and-directories\u002F09.passkeys",{"title":235,"path":236,"stem":237,"icon":156},"Calendar access","\u002Fen\u002Fsign-in-and-directories\u002Fcalendar-access","en\u002F04.sign-in-and-directories\u002F10.calendar-access",{"title":239,"icon":240,"path":241,"stem":242,"children":243,"page":30},"MCP server","i-hugeicons-ai-network","\u002Fen\u002Fmcp-server","en\u002F05.mcp-server",[244,248,253,257,262,266],{"title":245,"path":246,"stem":247,"icon":240},"Overview","\u002Fen\u002Fmcp-server\u002Foverview","en\u002F05.mcp-server\u002F01.overview",{"title":249,"path":250,"stem":251,"icon":252},"Setup","\u002Fen\u002Fmcp-server\u002Fsetup","en\u002F05.mcp-server\u002F02.setup","i-hugeicons-plug-socket",{"title":254,"path":255,"stem":256,"icon":111},"What you can do with it","\u002Fen\u002Fmcp-server\u002Fuse-cases","en\u002F05.mcp-server\u002F03.use-cases",{"title":258,"path":259,"stem":260,"icon":261},"Tools","\u002Fen\u002Fmcp-server\u002Ftools","en\u002F05.mcp-server\u002F04.tools","i-hugeicons-wrench-01",{"title":263,"path":264,"stem":265,"icon":76},"Approving changes","\u002Fen\u002Fmcp-server\u002Fapproving-changes","en\u002F05.mcp-server\u002F05.approving-changes",{"title":267,"path":268,"stem":269,"icon":270},"Administration & security","\u002Fen\u002Fmcp-server\u002Fadmin-and-security","en\u002F05.mcp-server\u002F06.admin-and-security","i-hugeicons-shield-key",{"title":272,"icon":273,"path":274,"stem":275,"children":276,"page":30},"External sources","i-hugeicons-database-sync","\u002Fen\u002Fexternal-sources","en\u002F06.external-sources",[277,280,285,290,295,300,305],{"title":245,"path":278,"stem":279,"icon":273},"\u002Fen\u002Fexternal-sources\u002Foverview","en\u002F06.external-sources\u002F01.overview",{"title":281,"path":282,"stem":283,"icon":284},"SharePoint","\u002Fen\u002Fexternal-sources\u002Fsharepoint","en\u002F06.external-sources\u002F02.sharepoint","i-hugeicons-microsoft",{"title":286,"path":287,"stem":288,"icon":289},"OneDrive","\u002Fen\u002Fexternal-sources\u002Fonedrive","en\u002F06.external-sources\u002F03.onedrive","i-hugeicons-folder-cloud",{"title":291,"path":292,"stem":293,"icon":294},"Google Drive","\u002Fen\u002Fexternal-sources\u002Fgoogle-drive","en\u002F06.external-sources\u002F04.google-drive","i-hugeicons-google-drive",{"title":296,"path":297,"stem":298,"icon":299},"FTP \u002F SFTP","\u002Fen\u002Fexternal-sources\u002Fftp-sftp","en\u002F06.external-sources\u002F05.ftp-sftp","i-hugeicons-server-stack-01",{"title":301,"path":302,"stem":303,"icon":304},"REST interface","\u002Fen\u002Fexternal-sources\u002Frest","en\u002F06.external-sources\u002F06.rest","i-hugeicons-api",{"title":306,"path":307,"stem":308,"icon":309},"SOAP interface","\u002Fen\u002Fexternal-sources\u002Fsoap","en\u002F06.external-sources\u002F07.soap","i-hugeicons-source-code",{"title":311,"icon":304,"path":312,"stem":313,"children":314,"page":30},"Integration API","\u002Fen\u002Fintegration-api","en\u002F07.integration-api",[315,318,322,327,332,337,341,346,350,354,359,364],{"title":245,"path":316,"stem":317,"icon":14},"\u002Fen\u002Fintegration-api\u002Foverview","en\u002F07.integration-api\u002F01.overview",{"title":319,"path":320,"stem":321,"icon":19},"Authentication","\u002Fen\u002Fintegration-api\u002Fauthentication","en\u002F07.integration-api\u002F02.authentication",{"title":323,"path":324,"stem":325,"icon":326},"Conventions","\u002Fen\u002Fintegration-api\u002Fconventions","en\u002F07.integration-api\u002F03.conventions","i-hugeicons-book-open-01",{"title":328,"path":329,"stem":330,"icon":331},"Pushing documents","\u002Fen\u002Fintegration-api\u002Fpushing-documents","en\u002F07.integration-api\u002F04.pushing-documents","i-hugeicons-upload-02",{"title":333,"path":334,"stem":335,"icon":336},"Consuming content","\u002Fen\u002Fintegration-api\u002Fconsuming-content","en\u002F07.integration-api\u002F05.consuming-content","i-hugeicons-download-02",{"title":338,"path":339,"stem":340,"icon":137},"Reference: documents","\u002Fen\u002Fintegration-api\u002Freference-documents","en\u002F07.integration-api\u002F06.reference-documents",{"title":342,"path":343,"stem":344,"icon":345},"Reference: categories, tags, markets","\u002Fen\u002Fintegration-api\u002Freference-categories-tags","en\u002F07.integration-api\u002F07.reference-categories-tags","i-hugeicons-folder-01",{"title":347,"path":348,"stem":349,"icon":211},"Reference: sync manifest","\u002Fen\u002Fintegration-api\u002Freference-sync","en\u002F07.integration-api\u002F08.reference-sync",{"title":351,"path":352,"stem":353,"icon":309},"OpenAPI","\u002Fen\u002Fintegration-api\u002Fopenapi","en\u002F07.integration-api\u002F09.openapi",{"title":355,"path":356,"stem":357,"icon":358},"Changelog","\u002Fen\u002Fintegration-api\u002Fchangelog","en\u002F07.integration-api\u002F10.changelog","i-hugeicons-time-schedule",{"title":360,"path":361,"stem":362,"icon":363},"Reference: groups, markets, access","\u002Fen\u002Fintegration-api\u002Freference-groups-access","en\u002F07.integration-api\u002F11.reference-groups-access","i-hugeicons-user-lock-01",{"title":365,"path":366,"stem":367,"icon":368},"Moving from CMWS","\u002Fen\u002Fintegration-api\u002Fcmws","en\u002F07.integration-api\u002F12.cmws","i-hugeicons-arrow-reload-horizontal",{"title":370,"icon":371,"path":372,"stem":373,"children":374,"page":30},"What's new","i-hugeicons-gift","\u002Fen\u002Fwhats-new","en\u002F08.whats-new",[375],{"title":355,"path":376,"stem":377,"icon":358},"\u002Fen\u002Fwhats-new\u002Fchangelog","en\u002F08.whats-new\u002F01.changelog",{"title":379,"icon":299,"path":380,"stem":381,"children":382,"page":30},"Self-hosting","\u002Fen\u002Fself-hosting","en\u002F09.self-hosting",[383,386,390,395,399,404,408,413,418,422],{"title":245,"path":384,"stem":385,"icon":14},"\u002Fen\u002Fself-hosting\u002Foverview","en\u002F09.self-hosting\u002F01.overview",{"title":387,"path":388,"stem":389,"icon":106},"Docker Compose","\u002Fen\u002Fself-hosting\u002Fdocker-compose","en\u002F09.self-hosting\u002F02.docker-compose",{"title":391,"path":392,"stem":393,"icon":394},"Kubernetes","\u002Fen\u002Fself-hosting\u002Fkubernetes","en\u002F09.self-hosting\u002F03.kubernetes","i-hugeicons-cloud",{"title":396,"path":397,"stem":398,"icon":101},"Configuration","\u002Fen\u002Fself-hosting\u002Fconfiguration","en\u002F09.self-hosting\u002F04.configuration",{"title":400,"path":401,"stem":402,"icon":403},"Licence","\u002Fen\u002Fself-hosting\u002Flicence","en\u002F09.self-hosting\u002F05.licence","i-hugeicons-license",{"title":405,"path":406,"stem":407,"icon":211},"Updates","\u002Fen\u002Fself-hosting\u002Fupdates","en\u002F09.self-hosting\u002F06.updates",{"title":409,"path":410,"stem":411,"icon":412},"Postgres","\u002Fen\u002Fself-hosting\u002Fpostgres","en\u002F09.self-hosting\u002F07.postgres","i-hugeicons-database",{"title":414,"path":415,"stem":416,"icon":417},"Backups","\u002Fen\u002Fself-hosting\u002Fbackups","en\u002F09.self-hosting\u002F08.backups","i-hugeicons-database-restore",{"title":419,"path":420,"stem":421,"icon":261},"Troubleshooting","\u002Fen\u002Fself-hosting\u002Ftroubleshooting","en\u002F09.self-hosting\u002F09.troubleshooting",{"title":423,"path":424,"stem":425,"icon":426},"Firewall","\u002Fen\u002Fself-hosting\u002Ffirewall","en\u002F09.self-hosting\u002F10.firewall","i-hugeicons-firewall",{"id":428,"title":360,"body":429,"description":1099,"extension":1100,"links":1101,"meta":1102,"navigation":1103,"path":361,"seo":1104,"stem":362,"__hash__":1105},"docs_en\u002Fen\u002F07.integration-api\u002F11.reference-groups-access.md",{"type":430,"value":431,"toc":1070},"minimark",[432,437,462,471,485,496,505,538,547,552,561,569,573,598,608,622,628,642,648,656,662,673,677,696,700,879,884,893,902,910,919,928,937,1038,1056,1066],[433,434,436],"h2",{"id":435},"the-group-object","The group object",[438,439,440,445,450,455,458],"field-group",{},[441,442],"field",{"name":443,"type":444},"id","uuid",[441,446,449],{"name":447,"type":448},"externalRef","string | null","The reference it was created with through the API.",[441,451,454],{"name":452,"type":453},"name","string","Unique in the organisation, at most 80 characters.",[441,456],{"name":457,"type":448},"description",[441,459],{"name":460,"type":461},"createdAt, updatedAt","date-time",[463,464,465,466,470],"p",{},"Creating, renaming and deleting a group needs an ",[467,468,469],"strong",{},"administrator"," as the key's person, as in Settings › Groups. Members are not managed through the API — they come from the CMS, single sign-on or a directory.",[433,472,474,478,479,478,482],{"id":473},"get-groups-get-groupsid-get-groupsrefref",[475,476,477],"code",{},"GET \u002Fgroups"," · ",[475,480,481],{},"GET \u002Fgroups\u002F{id}",[475,483,484],{},"GET \u002Fgroups\u002Fref\u002F{ref}",[463,486,487,488,491,492,495],{},"Scope ",[467,489,490],{},"read",". Every group by name, ",[475,493,494],{},"{ \"data\": Group[] }"," — or one.",[433,497,499,478,502],{"id":498},"post-groups-put-groupsrefref",[475,500,501],{},"POST \u002Fgroups",[475,503,504],{},"PUT \u002Fgroups\u002Fref\u002F{ref}",[463,506,487,507,510,511,514,515,518,519,522,523,526,527,529,530,533,534,537],{},[467,508,509],{},"write",". Body ",[475,512,513],{},"{ \"name\": \"…\", \"description\": \"…\" }",". ",[475,516,517],{},"POST"," answers ",[475,520,521],{},"201","; ",[475,524,525],{},"PUT"," by reference creates (",[475,528,521],{},") or updates (",[475,531,532],{},"200","), so the same request twice leaves one group. A name another group has is ",[475,535,536],{},"409",".",[433,539,541,478,544],{"id":540},"patch-groupsid-patch-groupsrefref",[475,542,543],{},"PATCH \u002Fgroups\u002F{id}",[475,545,546],{},"PATCH \u002Fgroups\u002Fref\u002F{ref}",[463,548,487,549,551],{},[467,550,509],{},". Rename, or change the description.",[433,553,555,478,558],{"id":554},"delete-groupsid-delete-groupsrefref",[475,556,557],{},"DELETE \u002Fgroups\u002F{id}",[475,559,560],{},"DELETE \u002Fgroups\u002Fref\u002F{ref}",[463,562,487,563,514,565,568],{},[467,564,509],{},[475,566,567],{},"204",". Its memberships go with it, and so does every grant it held.",[433,570,572],{"id":571},"markets","Markets",[463,574,575,576,578,579,582,583,586,587,590,591,594,595,597],{},"A market is a country: its ",[475,577,475],{}," (",[475,580,581],{},"DE",", ",[475,584,585],{},"AT",") keys every ",[475,588,589],{},"titles"," object and does not change. ",[475,592,593],{},"{ \"id\", \"code\", \"name\", \"locale\", \"isDefault\" }",". Writing needs an ",[467,596,469],{}," as the key's person, as in Settings › Markets.",[599,600,602,478,605],"h3",{"id":601},"get-markets-get-marketscode",[475,603,604],{},"GET \u002Fmarkets",[475,606,607],{},"GET \u002Fmarkets\u002F{code}",[463,609,487,610,612,613,616,617,619,620,537],{},[467,611,490],{},". Every market by code, ",[475,614,615],{},"{ \"data\": Market[] }"," — or one. ",[475,618,604],{}," now also answers each market's ",[475,621,443],{},[599,623,625],{"id":624},"post-markets",[475,626,627],{},"POST \u002Fmarkets",[463,629,487,630,514,632,635,636,638,639,641],{},[467,631,509],{},[475,633,634],{},"{ \"code\": \"AT\" }"," adds the market for a country — ",[475,637,521],{},", or ",[475,640,532],{}," with the market that is already there.",[599,643,645],{"id":644},"patch-marketscode",[475,646,647],{},"PATCH \u002Fmarkets\u002F{code}",[463,649,487,650,514,652,655],{},[467,651,509],{},[475,653,654],{},"{ \"name\": \"Österreich\", \"isDefault\": true }"," — either or both. Making one market the default ends it for the one before.",[599,657,659],{"id":658},"delete-marketscode",[475,660,661],{},"DELETE \u002Fmarkets\u002F{code}",[463,663,487,664,514,666,668,669,672],{},[467,665,509],{},[475,667,567],{},". Removes the market ",[467,670,671],{},"and every title given in it","; if it was the default, the next one by code takes over.",[433,674,676],{"id":675},"access","Access",[463,678,679,680,683,684,582,686,638,689,692,693,695],{},"Who may read a category or a document is decided by ",[467,681,682],{},"grants",": a group or one person, and a level — ",[475,685,490],{},[475,687,688],{},"full",[475,690,691],{},"none",". A category's grants apply to everything below it until a grant further down says otherwise; ",[475,694,691],{}," takes away what a category above gives. A document's own grants are exceptions to what its categories give.",[599,697,699],{"id":698},"the-access-object","The access object",[701,702,707],"pre",{"className":703,"code":704,"language":705,"meta":706,"style":706},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"grants\": [\n    { \"groupId\": \"3f2c…\", \"groupRef\": \"REGION-NORD\", \"level\": \"read\", \"inherited\": false },\n    { \"userEmail\": \"anna@example.com\", \"level\": \"full\", \"inherited\": true }\n  ]\n}\n","json","",[475,708,709,718,736,814,867,873],{"__ignoreMap":706},[710,711,714],"span",{"class":712,"line":713},"line",1,[710,715,717],{"class":716},"sMK4o","{\n",[710,719,721,724,727,730,733],{"class":712,"line":720},2,[710,722,723],{"class":716},"  \"",[710,725,682],{"class":726},"spNyl",[710,728,729],{"class":716},"\"",[710,731,732],{"class":716},":",[710,734,735],{"class":716}," [\n",[710,737,739,742,745,749,751,753,755,759,761,764,766,769,771,773,775,778,780,782,784,787,789,791,793,795,797,799,801,804,806,808,811],{"class":712,"line":738},3,[710,740,741],{"class":716},"    {",[710,743,744],{"class":716}," \"",[710,746,748],{"class":747},"sBMFI","groupId",[710,750,729],{"class":716},[710,752,732],{"class":716},[710,754,744],{"class":716},[710,756,758],{"class":757},"sfazB","3f2c…",[710,760,729],{"class":716},[710,762,763],{"class":716},",",[710,765,744],{"class":716},[710,767,768],{"class":747},"groupRef",[710,770,729],{"class":716},[710,772,732],{"class":716},[710,774,744],{"class":716},[710,776,777],{"class":757},"REGION-NORD",[710,779,729],{"class":716},[710,781,763],{"class":716},[710,783,744],{"class":716},[710,785,786],{"class":747},"level",[710,788,729],{"class":716},[710,790,732],{"class":716},[710,792,744],{"class":716},[710,794,490],{"class":757},[710,796,729],{"class":716},[710,798,763],{"class":716},[710,800,744],{"class":716},[710,802,803],{"class":747},"inherited",[710,805,729],{"class":716},[710,807,732],{"class":716},[710,809,810],{"class":716}," false",[710,812,813],{"class":716}," },\n",[710,815,817,819,821,824,826,828,830,833,835,837,839,841,843,845,847,849,851,853,855,857,859,861,864],{"class":712,"line":816},4,[710,818,741],{"class":716},[710,820,744],{"class":716},[710,822,823],{"class":747},"userEmail",[710,825,729],{"class":716},[710,827,732],{"class":716},[710,829,744],{"class":716},[710,831,832],{"class":757},"anna@example.com",[710,834,729],{"class":716},[710,836,763],{"class":716},[710,838,744],{"class":716},[710,840,786],{"class":747},[710,842,729],{"class":716},[710,844,732],{"class":716},[710,846,744],{"class":716},[710,848,688],{"class":757},[710,850,729],{"class":716},[710,852,763],{"class":716},[710,854,744],{"class":716},[710,856,803],{"class":747},[710,858,729],{"class":716},[710,860,732],{"class":716},[710,862,863],{"class":716}," true",[710,865,866],{"class":716}," }\n",[710,868,870],{"class":712,"line":869},5,[710,871,872],{"class":716},"  ]\n",[710,874,876],{"class":712,"line":875},6,[710,877,878],{"class":716},"}\n",[463,880,881,883],{},[475,882,803],{}," (categories only) marks a grant set on a category above, not on this one.",[599,885,887,478,890],{"id":886},"get-categoriesidaccess-get-categoriesrefrefaccess",[475,888,889],{},"GET \u002Fcategories\u002F{id}\u002Faccess",[475,891,892],{},"GET \u002Fcategories\u002Fref\u002F{ref}\u002Faccess",[599,894,896,478,899],{"id":895},"get-documentsidaccess-get-documentsrefrefaccess",[475,897,898],{},"GET \u002Fdocuments\u002F{id}\u002Faccess",[475,900,901],{},"GET \u002Fdocuments\u002Fref\u002F{ref}\u002Faccess",[463,903,487,904,906,907,909],{},[467,905,490],{},", and ",[467,908,688],{}," rights on the category or document for the key's person.",[599,911,913,478,916],{"id":912},"put-categoriesidaccess-put-categoriesrefrefaccess",[475,914,915],{},"PUT \u002Fcategories\u002F{id}\u002Faccess",[475,917,918],{},"PUT \u002Fcategories\u002Fref\u002F{ref}\u002Faccess",[599,920,922,478,925],{"id":921},"put-documentsidaccess-put-documentsrefrefaccess",[475,923,924],{},"PUT \u002Fdocuments\u002F{id}\u002Faccess",[475,926,927],{},"PUT \u002Fdocuments\u002Fref\u002F{ref}\u002Faccess",[463,929,487,930,932,933,936],{},[467,931,509],{},", full rights. The body is the ",[467,934,935],{},"whole set"," of explicit grants — a subject left out has none here and inherits:",[701,938,940],{"className":703,"code":939,"language":705,"meta":706,"style":706},"{\n  \"grants\": [\n    { \"groupRef\": \"REGION-NORD\", \"level\": \"read\" },\n    { \"userEmail\": \"anna@example.com\", \"level\": \"full\" }\n  ]\n}\n",[475,941,942,946,958,994,1030,1034],{"__ignoreMap":706},[710,943,944],{"class":712,"line":713},[710,945,717],{"class":716},[710,947,948,950,952,954,956],{"class":712,"line":720},[710,949,723],{"class":716},[710,951,682],{"class":726},[710,953,729],{"class":716},[710,955,732],{"class":716},[710,957,735],{"class":716},[710,959,960,962,964,966,968,970,972,974,976,978,980,982,984,986,988,990,992],{"class":712,"line":738},[710,961,741],{"class":716},[710,963,744],{"class":716},[710,965,768],{"class":747},[710,967,729],{"class":716},[710,969,732],{"class":716},[710,971,744],{"class":716},[710,973,777],{"class":757},[710,975,729],{"class":716},[710,977,763],{"class":716},[710,979,744],{"class":716},[710,981,786],{"class":747},[710,983,729],{"class":716},[710,985,732],{"class":716},[710,987,744],{"class":716},[710,989,490],{"class":757},[710,991,729],{"class":716},[710,993,813],{"class":716},[710,995,996,998,1000,1002,1004,1006,1008,1010,1012,1014,1016,1018,1020,1022,1024,1026,1028],{"class":712,"line":816},[710,997,741],{"class":716},[710,999,744],{"class":716},[710,1001,823],{"class":747},[710,1003,729],{"class":716},[710,1005,732],{"class":716},[710,1007,744],{"class":716},[710,1009,832],{"class":757},[710,1011,729],{"class":716},[710,1013,763],{"class":716},[710,1015,744],{"class":716},[710,1017,786],{"class":747},[710,1019,729],{"class":716},[710,1021,732],{"class":716},[710,1023,744],{"class":716},[710,1025,688],{"class":757},[710,1027,729],{"class":716},[710,1029,866],{"class":716},[710,1031,1032],{"class":712,"line":869},[710,1033,872],{"class":716},[710,1035,1036],{"class":712,"line":875},[710,1037,878],{"class":716},[463,1039,1040,1041,582,1043,1045,1046,1048,1049,1052,1053,537],{},"Name each grant's subject exactly once: ",[475,1042,748],{},[475,1044,768],{}," or ",[475,1047,823],{}," (a member of the organisation). An unknown reference or address is ",[475,1050,1051],{},"400",", naming it in ",[475,1054,1055],{},"issues",[463,1057,1058,1059,1062,1063,1065],{},"For a document, ",[475,1060,1061],{},"\"restrictToGrantedUsers\": true"," makes it readable for the people named only: every group its categories would let in gets ",[475,1064,691],{},". That holds for the groups that reach it when you send it — a group given access to the category later is not held back.",[1067,1068,1069],"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 .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 .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":706,"searchDepth":720,"depth":720,"links":1071},[1072,1073,1075,1077,1079,1081,1088],{"id":435,"depth":720,"text":436},{"id":473,"depth":720,"text":1074},"GET \u002Fgroups · GET \u002Fgroups\u002F{id} · GET \u002Fgroups\u002Fref\u002F{ref}",{"id":498,"depth":720,"text":1076},"POST \u002Fgroups · PUT \u002Fgroups\u002Fref\u002F{ref}",{"id":540,"depth":720,"text":1078},"PATCH \u002Fgroups\u002F{id} · PATCH \u002Fgroups\u002Fref\u002F{ref}",{"id":554,"depth":720,"text":1080},"DELETE \u002Fgroups\u002F{id} · DELETE \u002Fgroups\u002Fref\u002F{ref}",{"id":571,"depth":720,"text":572,"children":1082},[1083,1085,1086,1087],{"id":601,"depth":738,"text":1084},"GET \u002Fmarkets · GET \u002Fmarkets\u002F{code}",{"id":624,"depth":738,"text":627},{"id":644,"depth":738,"text":647},{"id":658,"depth":738,"text":661},{"id":675,"depth":720,"text":676,"children":1089},[1090,1091,1093,1095,1097],{"id":698,"depth":738,"text":699},{"id":886,"depth":738,"text":1092},"GET \u002Fcategories\u002F{id}\u002Faccess · GET \u002Fcategories\u002Fref\u002F{ref}\u002Faccess",{"id":895,"depth":738,"text":1094},"GET \u002Fdocuments\u002F{id}\u002Faccess · GET \u002Fdocuments\u002Fref\u002F{ref}\u002Faccess",{"id":912,"depth":738,"text":1096},"PUT \u002Fcategories\u002F{id}\u002Faccess · PUT \u002Fcategories\u002Fref\u002F{ref}\u002Faccess",{"id":921,"depth":738,"text":1098},"PUT \u002Fdocuments\u002F{id}\u002Faccess · PUT \u002Fdocuments\u002Fref\u002F{ref}\u002Faccess","Groups, adding and removing markets, and who may read a category or a document.","md",null,{},{"icon":363},{"title":360,"description":1099},"VJxQfmzl9ID_fTl-XUjkzxOJhvQzLDOcpfL0EdOL41U",[1107,1109],{"title":355,"path":356,"stem":357,"description":1108,"icon":358,"children":-1},"Changes to the integration API.",{"title":365,"path":366,"stem":367,"description":1110,"icon":368,"children":-1},"The old DDM's CMWS interface keeps working — change the address, nothing else.",1793617722865]