[{"data":1,"prerenderedAt":2149},["ShallowReactive",2],{"navigation_docs_en":3,"-en-integration-api-pushing-documents":427,"-en-integration-api-pushing-documents-surround":2144},[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":328,"body":429,"description":2137,"extension":2138,"links":2139,"meta":2140,"navigation":2141,"path":329,"seo":2142,"stem":330,"__hash__":2143},"docs_en\u002Fen\u002F07.integration-api\u002F04.pushing-documents.md",{"type":430,"value":431,"toc":2125},"minimark",[432,441,446,465,578,589,596,600,612,616,626,1286,1289,1580,1660,1667,1670,1740,1744,1751,1811,1821,1824,1828,1873,1929,1933,1944,2053,2064,2068,2071,2114,2121],[433,434,435,436,440],"p",{},"Pushing means the other system sends each document to DDM itself, by its ",[437,438,439],"strong",{},"own reference",". The same document sent again is the same document in DDM: unchanged bytes do nothing, new bytes become a new version.",[442,443,445],"h2",{"id":444},"_1-set-up-a-push-source","1. Set up a push source",[433,447,448,449,452,453,456,457,460,461,464],{},"Under ",[437,450,451],{},"Settings › External sources",", click ",[437,454,455],{},"New source"," and choose the system type ",[437,458,459],{},"Push (external API)",". A push source has nothing to connect to. Its settings decide how pushed documents are ",[437,462,463],{},"filed",", exactly as for a connector:",[466,467,468,481],"table",{},[469,470,471],"thead",{},[472,473,474,478],"tr",{},[475,476,477],"th",{},"Setting",[475,479,480],{},"Effect on pushed documents",[482,483,484,516,528,550,564],"tbody",{},[472,485,486,492],{},[487,488,489],"td",{},[437,490,491],{},"Category mapping",[487,493,494,498,499,503,504,507,508,511,512,515],{},[495,496,497],"em",{},"Mirror the folder structure"," builds the ",[500,501,502],"code",{},"categoryPath"," you send as a category tree. ",[495,505,506],{},"Everything into one category"," makes one top-level category named after the whole path (",[500,509,510],{},"Products \u002F Price lists","). ",[495,513,514],{},"Fixed category"," files everything into the category chosen, whatever is sent",[472,517,518,523],{},[487,519,520],{},[437,521,522],{},"Import categories",[487,524,525,526],{},"Off: no categories are created from ",[500,527,502],{},[472,529,530,535],{},[487,531,532],{},[437,533,534],{},"Already present",[487,536,537,538,541,542,545,546,549],{},"When a document with this reference exists: ",[495,539,540],{},"Store as a new version"," (default), ",[495,543,544],{},"Overwrite"," (replace the current version) or ",[495,547,548],{},"Skip"," (leave it alone)",[472,551,552,557],{},[487,553,554],{},[437,555,556],{},"File filter",[487,558,559,560,563],{},"e.g. ",[500,561,562],{},"*.pdf"," – other names are skipped",[472,565,566,571],{},[487,567,568],{},[437,569,570],{},"Group mappings",[487,572,573,574,577],{},"A ",[500,575,576],{},"groupName"," you send becomes read access for the mapped DDM group",[433,579,580,581,584,585,588],{},"Switch the source ",[437,582,583],{},"on",". Pushes to a source that is switched off are refused with ",[500,586,587],{},"403",".",[433,590,591,592,595],{},"See ",[593,594,272],"a",{"href":278}," for these settings in detail.",[442,597,599],{"id":598},"_2-create-a-key-that-writes","2. Create a key that writes",[433,601,448,602,605,606,609,610,588],{},[437,603,604],{},"Settings › API access",", create a key with ",[437,607,608],{},"Write"," and choose the push source. Pushed documents belong to that source, and their references are unique within it. Let the key act as a person who may create documents in the target categories – see ",[593,611,319],{"href":320},[442,613,615],{"id":614},"_3-push-a-document","3. Push a document",[433,617,618,621,622,625],{},[500,619,620],{},"PUT \u002Fdocuments\u002Fref\u002F{ref}"," creates the document or updates it. Send the file as multipart, with the details as JSON in a ",[500,623,624],{},"metadata"," part:",[627,628,629,715,1150,1243],"code-group",{},[630,631,637],"pre",{"className":632,"code":633,"filename":634,"language":635,"meta":636,"style":636},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -X PUT \"https:\u002F\u002Fddm.example.com\u002Fapi\u002Fext\u002Fv1\u002Fdocuments\u002Fref\u002FPIM-4711\" \\\n  -H \"Authorization: Bearer $DDM_API_KEY\" \\\n  -F \"file=@Preisliste-2026.pdf;type=application\u002Fpdf\" \\\n  -F 'metadata={\"categoryPath\":\"Products\u002FPrice lists\",\"tags\":[\"Prices\",\"2026\"],\"titles\":{\"DE\":\"Preisliste 2026\",\"AT\":\"Preisliste 2026\"}};type=application\u002Fjson'\n","curl","bash","",[500,638,639,668,686,701],{"__ignoreMap":636},[640,641,644,647,651,654,658,661,664],"span",{"class":642,"line":643},"line",1,[640,645,634],{"class":646},"sBMFI",[640,648,650],{"class":649},"sfazB"," -X",[640,652,653],{"class":649}," PUT",[640,655,657],{"class":656},"sMK4o"," \"",[640,659,660],{"class":649},"https:\u002F\u002Fddm.example.com\u002Fapi\u002Fext\u002Fv1\u002Fdocuments\u002Fref\u002FPIM-4711",[640,662,663],{"class":656},"\"",[640,665,667],{"class":666},"sTEyZ"," \\\n",[640,669,671,674,676,679,682,684],{"class":642,"line":670},2,[640,672,673],{"class":649},"  -H",[640,675,657],{"class":656},[640,677,678],{"class":649},"Authorization: Bearer ",[640,680,681],{"class":666},"$DDM_API_KEY",[640,683,663],{"class":656},[640,685,667],{"class":666},[640,687,689,692,694,697,699],{"class":642,"line":688},3,[640,690,691],{"class":649},"  -F",[640,693,657],{"class":656},[640,695,696],{"class":649},"file=@Preisliste-2026.pdf;type=application\u002Fpdf",[640,698,663],{"class":656},[640,700,667],{"class":666},[640,702,704,706,709,712],{"class":642,"line":703},4,[640,705,691],{"class":649},[640,707,708],{"class":656}," '",[640,710,711],{"class":649},"metadata={\"categoryPath\":\"Products\u002FPrice lists\",\"tags\":[\"Prices\",\"2026\"],\"titles\":{\"DE\":\"Preisliste 2026\",\"AT\":\"Preisliste 2026\"}};type=application\u002Fjson",[640,713,714],{"class":656},"'\n",[630,716,721],{"className":717,"code":718,"filename":719,"language":720,"meta":636,"style":636},"language-js shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { readFile } from 'node:fs\u002Fpromises'\n\nconst form = new FormData()\nform.append('file', new Blob([await readFile('Preisliste-2026.pdf')], { type: 'application\u002Fpdf' }), 'Preisliste-2026.pdf')\nform.append('metadata', JSON.stringify({\n  categoryPath: 'Products\u002FPrice lists',\n  tags: ['Prices', '2026'],\n  titles: { DE: 'Preisliste 2026', AT: 'Preisliste 2026' }\n}))\n\nconst response = await fetch(`https:\u002F\u002Fddm.example.com\u002Fapi\u002Fext\u002Fv1\u002Fdocuments\u002Fref\u002F${encodeURIComponent('PIM-4711')}`, {\n  method: 'PUT',\n  headers: { Authorization: `Bearer ${process.env.DDM_API_KEY}` },\n  body: form\n})\nconst { outcome, document } = await response.json()\n","JavaScript","js",[500,722,723,748,754,776,859,891,909,941,979,988,993,1042,1059,1100,1111,1118],{"__ignoreMap":636},[640,724,725,729,732,735,738,741,743,746],{"class":642,"line":643},[640,726,728],{"class":727},"s7zQu","import",[640,730,731],{"class":656}," {",[640,733,734],{"class":666}," readFile",[640,736,737],{"class":656}," }",[640,739,740],{"class":727}," from",[640,742,708],{"class":656},[640,744,745],{"class":649},"node:fs\u002Fpromises",[640,747,714],{"class":656},[640,749,750],{"class":642,"line":670},[640,751,753],{"emptyLinePlaceholder":752},true,"\n",[640,755,756,760,763,766,769,773],{"class":642,"line":688},[640,757,759],{"class":758},"spNyl","const",[640,761,762],{"class":666}," form ",[640,764,765],{"class":656},"=",[640,767,768],{"class":656}," new",[640,770,772],{"class":771},"s2Zo4"," FormData",[640,774,775],{"class":666},"()\n",[640,777,778,781,783,786,789,792,795,797,800,802,805,808,811,813,815,817,820,822,825,827,829,833,836,838,841,843,845,848,850,852,854,856],{"class":642,"line":703},[640,779,780],{"class":666},"form",[640,782,588],{"class":656},[640,784,785],{"class":771},"append",[640,787,788],{"class":666},"(",[640,790,791],{"class":656},"'",[640,793,794],{"class":649},"file",[640,796,791],{"class":656},[640,798,799],{"class":656},",",[640,801,768],{"class":656},[640,803,804],{"class":771}," Blob",[640,806,807],{"class":666},"([",[640,809,810],{"class":727},"await",[640,812,734],{"class":771},[640,814,788],{"class":666},[640,816,791],{"class":656},[640,818,819],{"class":649},"Preisliste-2026.pdf",[640,821,791],{"class":656},[640,823,824],{"class":666},")]",[640,826,799],{"class":656},[640,828,731],{"class":656},[640,830,832],{"class":831},"swJcz"," type",[640,834,835],{"class":656},":",[640,837,708],{"class":656},[640,839,840],{"class":649},"application\u002Fpdf",[640,842,791],{"class":656},[640,844,737],{"class":656},[640,846,847],{"class":666},")",[640,849,799],{"class":656},[640,851,708],{"class":656},[640,853,819],{"class":649},[640,855,791],{"class":656},[640,857,858],{"class":666},")\n",[640,860,862,864,866,868,870,872,874,876,878,881,883,886,888],{"class":642,"line":861},5,[640,863,780],{"class":666},[640,865,588],{"class":656},[640,867,785],{"class":771},[640,869,788],{"class":666},[640,871,791],{"class":656},[640,873,624],{"class":649},[640,875,791],{"class":656},[640,877,799],{"class":656},[640,879,880],{"class":666}," JSON",[640,882,588],{"class":656},[640,884,885],{"class":771},"stringify",[640,887,788],{"class":666},[640,889,890],{"class":656},"{\n",[640,892,894,897,899,901,904,906],{"class":642,"line":893},6,[640,895,896],{"class":831},"  categoryPath",[640,898,835],{"class":656},[640,900,708],{"class":656},[640,902,903],{"class":649},"Products\u002FPrice lists",[640,905,791],{"class":656},[640,907,908],{"class":656},",\n",[640,910,912,915,917,920,922,925,927,929,931,934,936,939],{"class":642,"line":911},7,[640,913,914],{"class":831},"  tags",[640,916,835],{"class":656},[640,918,919],{"class":666}," [",[640,921,791],{"class":656},[640,923,924],{"class":649},"Prices",[640,926,791],{"class":656},[640,928,799],{"class":656},[640,930,708],{"class":656},[640,932,933],{"class":649},"2026",[640,935,791],{"class":656},[640,937,938],{"class":666},"]",[640,940,908],{"class":656},[640,942,944,947,949,951,954,956,958,961,963,965,968,970,972,974,976],{"class":642,"line":943},8,[640,945,946],{"class":831},"  titles",[640,948,835],{"class":656},[640,950,731],{"class":656},[640,952,953],{"class":831}," DE",[640,955,835],{"class":656},[640,957,708],{"class":656},[640,959,960],{"class":649},"Preisliste 2026",[640,962,791],{"class":656},[640,964,799],{"class":656},[640,966,967],{"class":831}," AT",[640,969,835],{"class":656},[640,971,708],{"class":656},[640,973,960],{"class":649},[640,975,791],{"class":656},[640,977,978],{"class":656}," }\n",[640,980,982,985],{"class":642,"line":981},9,[640,983,984],{"class":656},"}",[640,986,987],{"class":666},"))\n",[640,989,991],{"class":642,"line":990},10,[640,992,753],{"emptyLinePlaceholder":752},[640,994,996,998,1001,1003,1006,1009,1011,1014,1017,1020,1023,1025,1027,1030,1032,1034,1037,1039],{"class":642,"line":995},11,[640,997,759],{"class":758},[640,999,1000],{"class":666}," response ",[640,1002,765],{"class":656},[640,1004,1005],{"class":727}," await",[640,1007,1008],{"class":771}," fetch",[640,1010,788],{"class":666},[640,1012,1013],{"class":656},"`",[640,1015,1016],{"class":649},"https:\u002F\u002Fddm.example.com\u002Fapi\u002Fext\u002Fv1\u002Fdocuments\u002Fref\u002F",[640,1018,1019],{"class":656},"${",[640,1021,1022],{"class":771},"encodeURIComponent",[640,1024,788],{"class":666},[640,1026,791],{"class":656},[640,1028,1029],{"class":649},"PIM-4711",[640,1031,791],{"class":656},[640,1033,847],{"class":666},[640,1035,1036],{"class":656},"}`",[640,1038,799],{"class":656},[640,1040,1041],{"class":656}," {\n",[640,1043,1045,1048,1050,1052,1055,1057],{"class":642,"line":1044},12,[640,1046,1047],{"class":831},"  method",[640,1049,835],{"class":656},[640,1051,708],{"class":656},[640,1053,1054],{"class":649},"PUT",[640,1056,791],{"class":656},[640,1058,908],{"class":656},[640,1060,1062,1065,1067,1069,1072,1074,1077,1080,1082,1085,1087,1090,1092,1095,1097],{"class":642,"line":1061},13,[640,1063,1064],{"class":831},"  headers",[640,1066,835],{"class":656},[640,1068,731],{"class":656},[640,1070,1071],{"class":831}," Authorization",[640,1073,835],{"class":656},[640,1075,1076],{"class":656}," `",[640,1078,1079],{"class":649},"Bearer ",[640,1081,1019],{"class":656},[640,1083,1084],{"class":666},"process",[640,1086,588],{"class":656},[640,1088,1089],{"class":666},"env",[640,1091,588],{"class":656},[640,1093,1094],{"class":666},"DDM_API_KEY",[640,1096,1036],{"class":656},[640,1098,1099],{"class":656}," },\n",[640,1101,1103,1106,1108],{"class":642,"line":1102},14,[640,1104,1105],{"class":831},"  body",[640,1107,835],{"class":656},[640,1109,1110],{"class":666}," form\n",[640,1112,1114,1116],{"class":642,"line":1113},15,[640,1115,984],{"class":656},[640,1117,858],{"class":666},[640,1119,1121,1123,1125,1128,1130,1133,1135,1138,1140,1143,1145,1148],{"class":642,"line":1120},16,[640,1122,759],{"class":758},[640,1124,731],{"class":656},[640,1126,1127],{"class":666}," outcome",[640,1129,799],{"class":656},[640,1131,1132],{"class":666}," document ",[640,1134,984],{"class":656},[640,1136,1137],{"class":656}," =",[640,1139,1005],{"class":727},[640,1141,1142],{"class":666}," response",[640,1144,588],{"class":656},[640,1146,1147],{"class":771},"json",[640,1149,775],{"class":666},[630,1151,1156],{"className":1152,"code":1153,"filename":1154,"language":1155,"meta":636,"style":636},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import json, os, requests\nfrom urllib.parse import quote\n\nwith open(\"Preisliste-2026.pdf\", \"rb\") as file:\n    response = requests.put(\n        f\"https:\u002F\u002Fddm.example.com\u002Fapi\u002Fext\u002Fv1\u002Fdocuments\u002Fref\u002F{quote('PIM-4711', safe='')}\",\n        headers={\"Authorization\": f\"Bearer {os.environ['DDM_API_KEY']}\"},\n        files={\n            \"file\": (\"Preisliste-2026.pdf\", file, \"application\u002Fpdf\"),\n            \"metadata\": (None, json.dumps({\n                \"categoryPath\": \"Products\u002FPrice lists\",\n                \"tags\": [\"Prices\", \"2026\"],\n                \"titles\": {\"DE\": \"Preisliste 2026\", \"AT\": \"Preisliste 2026\"},\n            }), \"application\u002Fjson\"),\n        },\n    )\nresult = response.json()\n","Python","python",[500,1157,1158,1163,1168,1172,1177,1182,1187,1192,1197,1202,1207,1212,1217,1222,1227,1232,1237],{"__ignoreMap":636},[640,1159,1160],{"class":642,"line":643},[640,1161,1162],{},"import json, os, requests\n",[640,1164,1165],{"class":642,"line":670},[640,1166,1167],{},"from urllib.parse import quote\n",[640,1169,1170],{"class":642,"line":688},[640,1171,753],{"emptyLinePlaceholder":752},[640,1173,1174],{"class":642,"line":703},[640,1175,1176],{},"with open(\"Preisliste-2026.pdf\", \"rb\") as file:\n",[640,1178,1179],{"class":642,"line":861},[640,1180,1181],{},"    response = requests.put(\n",[640,1183,1184],{"class":642,"line":893},[640,1185,1186],{},"        f\"https:\u002F\u002Fddm.example.com\u002Fapi\u002Fext\u002Fv1\u002Fdocuments\u002Fref\u002F{quote('PIM-4711', safe='')}\",\n",[640,1188,1189],{"class":642,"line":911},[640,1190,1191],{},"        headers={\"Authorization\": f\"Bearer {os.environ['DDM_API_KEY']}\"},\n",[640,1193,1194],{"class":642,"line":943},[640,1195,1196],{},"        files={\n",[640,1198,1199],{"class":642,"line":981},[640,1200,1201],{},"            \"file\": (\"Preisliste-2026.pdf\", file, \"application\u002Fpdf\"),\n",[640,1203,1204],{"class":642,"line":990},[640,1205,1206],{},"            \"metadata\": (None, json.dumps({\n",[640,1208,1209],{"class":642,"line":995},[640,1210,1211],{},"                \"categoryPath\": \"Products\u002FPrice lists\",\n",[640,1213,1214],{"class":642,"line":1044},[640,1215,1216],{},"                \"tags\": [\"Prices\", \"2026\"],\n",[640,1218,1219],{"class":642,"line":1061},[640,1220,1221],{},"                \"titles\": {\"DE\": \"Preisliste 2026\", \"AT\": \"Preisliste 2026\"},\n",[640,1223,1224],{"class":642,"line":1102},[640,1225,1226],{},"            }), \"application\u002Fjson\"),\n",[640,1228,1229],{"class":642,"line":1113},[640,1230,1231],{},"        },\n",[640,1233,1234],{"class":642,"line":1120},[640,1235,1236],{},"    )\n",[640,1238,1240],{"class":642,"line":1239},17,[640,1241,1242],{},"result = response.json()\n",[630,1244,1249],{"className":1245,"code":1246,"filename":1247,"language":1248,"meta":636,"style":636},"language-powershell shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","$form = @{\n  file     = Get-Item \"Preisliste-2026.pdf\"\n  metadata = '{\"categoryPath\":\"Products\u002FPrice lists\",\"tags\":[\"Prices\",\"2026\"]}'\n}\nInvoke-RestMethod -Method Put -Form $form `\n  -Uri \"https:\u002F\u002Fddm.example.com\u002Fapi\u002Fext\u002Fv1\u002Fdocuments\u002Fref\u002FPIM-4711\" `\n  -Headers @{ Authorization = \"Bearer $env:DDM_API_KEY\" }\n","PowerShell","powershell",[500,1250,1251,1256,1261,1266,1271,1276,1281],{"__ignoreMap":636},[640,1252,1253],{"class":642,"line":643},[640,1254,1255],{},"$form = @{\n",[640,1257,1258],{"class":642,"line":670},[640,1259,1260],{},"  file     = Get-Item \"Preisliste-2026.pdf\"\n",[640,1262,1263],{"class":642,"line":688},[640,1264,1265],{},"  metadata = '{\"categoryPath\":\"Products\u002FPrice lists\",\"tags\":[\"Prices\",\"2026\"]}'\n",[640,1267,1268],{"class":642,"line":703},[640,1269,1270],{},"}\n",[640,1272,1273],{"class":642,"line":861},[640,1274,1275],{},"Invoke-RestMethod -Method Put -Form $form `\n",[640,1277,1278],{"class":642,"line":893},[640,1279,1280],{},"  -Uri \"https:\u002F\u002Fddm.example.com\u002Fapi\u002Fext\u002Fv1\u002Fdocuments\u002Fref\u002FPIM-4711\" `\n",[640,1282,1283],{"class":642,"line":911},[640,1284,1285],{},"  -Headers @{ Authorization = \"Bearer $env:DDM_API_KEY\" }\n",[433,1287,1288],{},"The answer says what happened, and shows the document:",[630,1290,1293],{"className":1291,"code":1292,"language":1147,"meta":636,"style":636},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"outcome\": \"created\",\n  \"document\": {\n    \"id\": \"8d0c1f5e-6c43-4f0e-9a52-0b7f1a2c3d4e\",\n    \"externalRef\": \"PIM-4711\",\n    \"name\": \"Preisliste-2026.pdf\",\n    \"status\": \"draft\",\n    \"tags\": [\"2026\", \"Prices\"],\n    \"titles\": { \"DE\": \"Preisliste 2026\", \"AT\": \"Preisliste 2026\" },\n    \"categoryIds\": [\"2b5e…\"],\n    \"currentVersion\": { \"versionNo\": 1, \"checksum\": \"9f86d0…\", \"sizeBytes\": 48211 }\n  }\n}\n",[500,1294,1295,1299,1320,1333,1354,1373,1392,1412,1442,1490,1512,1571,1576],{"__ignoreMap":636},[640,1296,1297],{"class":642,"line":643},[640,1298,890],{"class":656},[640,1300,1301,1304,1307,1309,1311,1313,1316,1318],{"class":642,"line":670},[640,1302,1303],{"class":656},"  \"",[640,1305,1306],{"class":758},"outcome",[640,1308,663],{"class":656},[640,1310,835],{"class":656},[640,1312,657],{"class":656},[640,1314,1315],{"class":649},"created",[640,1317,663],{"class":656},[640,1319,908],{"class":656},[640,1321,1322,1324,1327,1329,1331],{"class":642,"line":688},[640,1323,1303],{"class":656},[640,1325,1326],{"class":758},"document",[640,1328,663],{"class":656},[640,1330,835],{"class":656},[640,1332,1041],{"class":656},[640,1334,1335,1338,1341,1343,1345,1347,1350,1352],{"class":642,"line":703},[640,1336,1337],{"class":656},"    \"",[640,1339,1340],{"class":646},"id",[640,1342,663],{"class":656},[640,1344,835],{"class":656},[640,1346,657],{"class":656},[640,1348,1349],{"class":649},"8d0c1f5e-6c43-4f0e-9a52-0b7f1a2c3d4e",[640,1351,663],{"class":656},[640,1353,908],{"class":656},[640,1355,1356,1358,1361,1363,1365,1367,1369,1371],{"class":642,"line":861},[640,1357,1337],{"class":656},[640,1359,1360],{"class":646},"externalRef",[640,1362,663],{"class":656},[640,1364,835],{"class":656},[640,1366,657],{"class":656},[640,1368,1029],{"class":649},[640,1370,663],{"class":656},[640,1372,908],{"class":656},[640,1374,1375,1377,1380,1382,1384,1386,1388,1390],{"class":642,"line":893},[640,1376,1337],{"class":656},[640,1378,1379],{"class":646},"name",[640,1381,663],{"class":656},[640,1383,835],{"class":656},[640,1385,657],{"class":656},[640,1387,819],{"class":649},[640,1389,663],{"class":656},[640,1391,908],{"class":656},[640,1393,1394,1396,1399,1401,1403,1405,1408,1410],{"class":642,"line":911},[640,1395,1337],{"class":656},[640,1397,1398],{"class":646},"status",[640,1400,663],{"class":656},[640,1402,835],{"class":656},[640,1404,657],{"class":656},[640,1406,1407],{"class":649},"draft",[640,1409,663],{"class":656},[640,1411,908],{"class":656},[640,1413,1414,1416,1419,1421,1423,1425,1427,1429,1431,1433,1435,1437,1439],{"class":642,"line":943},[640,1415,1337],{"class":656},[640,1417,1418],{"class":646},"tags",[640,1420,663],{"class":656},[640,1422,835],{"class":656},[640,1424,919],{"class":656},[640,1426,663],{"class":656},[640,1428,933],{"class":649},[640,1430,663],{"class":656},[640,1432,799],{"class":656},[640,1434,657],{"class":656},[640,1436,924],{"class":649},[640,1438,663],{"class":656},[640,1440,1441],{"class":656},"],\n",[640,1443,1444,1446,1449,1451,1453,1455,1457,1461,1463,1465,1467,1469,1471,1473,1475,1478,1480,1482,1484,1486,1488],{"class":642,"line":981},[640,1445,1337],{"class":656},[640,1447,1448],{"class":646},"titles",[640,1450,663],{"class":656},[640,1452,835],{"class":656},[640,1454,731],{"class":656},[640,1456,657],{"class":656},[640,1458,1460],{"class":1459},"sbssI","DE",[640,1462,663],{"class":656},[640,1464,835],{"class":656},[640,1466,657],{"class":656},[640,1468,960],{"class":649},[640,1470,663],{"class":656},[640,1472,799],{"class":656},[640,1474,657],{"class":656},[640,1476,1477],{"class":1459},"AT",[640,1479,663],{"class":656},[640,1481,835],{"class":656},[640,1483,657],{"class":656},[640,1485,960],{"class":649},[640,1487,663],{"class":656},[640,1489,1099],{"class":656},[640,1491,1492,1494,1497,1499,1501,1503,1505,1508,1510],{"class":642,"line":990},[640,1493,1337],{"class":656},[640,1495,1496],{"class":646},"categoryIds",[640,1498,663],{"class":656},[640,1500,835],{"class":656},[640,1502,919],{"class":656},[640,1504,663],{"class":656},[640,1506,1507],{"class":649},"2b5e…",[640,1509,663],{"class":656},[640,1511,1441],{"class":656},[640,1513,1514,1516,1519,1521,1523,1525,1527,1530,1532,1534,1537,1539,1541,1544,1546,1548,1550,1553,1555,1557,1559,1562,1564,1566,1569],{"class":642,"line":995},[640,1515,1337],{"class":656},[640,1517,1518],{"class":646},"currentVersion",[640,1520,663],{"class":656},[640,1522,835],{"class":656},[640,1524,731],{"class":656},[640,1526,657],{"class":656},[640,1528,1529],{"class":1459},"versionNo",[640,1531,663],{"class":656},[640,1533,835],{"class":656},[640,1535,1536],{"class":1459}," 1",[640,1538,799],{"class":656},[640,1540,657],{"class":656},[640,1542,1543],{"class":1459},"checksum",[640,1545,663],{"class":656},[640,1547,835],{"class":656},[640,1549,657],{"class":656},[640,1551,1552],{"class":649},"9f86d0…",[640,1554,663],{"class":656},[640,1556,799],{"class":656},[640,1558,657],{"class":656},[640,1560,1561],{"class":1459},"sizeBytes",[640,1563,663],{"class":656},[640,1565,835],{"class":656},[640,1567,1568],{"class":1459}," 48211",[640,1570,978],{"class":656},[640,1572,1573],{"class":642,"line":1044},[640,1574,1575],{"class":656},"  }\n",[640,1577,1578],{"class":642,"line":1061},[640,1579,1270],{"class":656},[466,1581,1582,1596],{},[469,1583,1584],{},[472,1585,1586,1590,1593],{},[475,1587,1588],{},[500,1589,1306],{},[475,1591,1592],{},"Status",[475,1594,1595],{},"Meaning",[482,1597,1598,1610,1625,1637],{},[472,1599,1600,1604,1607],{},[487,1601,1602],{},[500,1603,1315],{},[487,1605,1606],{},"201",[487,1608,1609],{},"A new document",[472,1611,1612,1617,1620],{},[487,1613,1614],{},[500,1615,1616],{},"versioned",[487,1618,1619],{},"200",[487,1621,1622,1623],{},"New bytes on an existing document – a new version, or replaced under ",[495,1624,544],{},[472,1626,1627,1632,1634],{},[487,1628,1629],{},[500,1630,1631],{},"unchanged",[487,1633,1619],{},[487,1635,1636],{},"The same bytes as the current version – nothing changed",[472,1638,1639,1644,1646],{},[487,1640,1641],{},[500,1642,1643],{},"skipped",[487,1645,1619],{},[487,1647,1648,1649,1651,1652,1654,1655,1651,1657],{},"The file filter left it out, or the document exists and ",[495,1650,534],{}," is ",[495,1653,548],{},". ",[500,1656,1326],{},[500,1658,1659],{},"null",[1661,1662,1664,1665,847],"h3",{"id":1663},"the-details-metadata","The details (",[500,1666,624],{},[433,1668,1669],{},"All optional:",[466,1671,1672,1681],{},[469,1673,1674],{},[472,1675,1676,1679],{},[475,1677,1678],{},"Field",[475,1680,1595],{},[482,1682,1683,1692,1703,1713,1722,1731],{},[472,1684,1685,1689],{},[487,1686,1687],{},[500,1688,1379],{},[487,1690,1691],{},"The file name, with its extension. Default: the uploaded file's name",[472,1693,1694,1698],{},[487,1695,1696],{},[500,1697,502],{},[487,1699,559,1700,1702],{},[500,1701,903],{},". Missing categories are created, according to the category mapping",[472,1704,1705,1710],{},[487,1706,1707],{},[500,1708,1709],{},"mimeType",[487,1711,1712],{},"Overrides the file's declared type",[472,1714,1715,1719],{},[487,1716,1717],{},[500,1718,1418],{},[487,1720,1721],{},"Replaces the document's tags",[472,1723,1724,1728],{},[487,1725,1726],{},[500,1727,1448],{},[487,1729,1730],{},"Titles per market code, merged with the existing ones",[472,1732,1733,1737],{},[487,1734,1735],{},[500,1736,576],{},[487,1738,1739],{},"An external group, mapped by the source's group mapping",[1661,1741,1743],{"id":1742},"or-from-a-url","Or: from a URL",[433,1745,1746,1747,1750],{},"Instead of uploading, send JSON with a ",[500,1748,1749],{},"fileUrl",". DDM downloads the file itself:",[630,1752,1754],{"className":632,"code":1753,"language":635,"meta":636,"style":636},"curl -X PUT \"https:\u002F\u002Fddm.example.com\u002Fapi\u002Fext\u002Fv1\u002Fdocuments\u002Fref\u002FPIM-4711\" \\\n  -H \"Authorization: Bearer $DDM_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"fileUrl\":\"https:\u002F\u002Fpim.example.com\u002Fexport\u002F4711.pdf\",\"categoryPath\":\"Products\u002FPrice lists\"}'\n",[500,1755,1756,1772,1786,1799],{"__ignoreMap":636},[640,1757,1758,1760,1762,1764,1766,1768,1770],{"class":642,"line":643},[640,1759,634],{"class":646},[640,1761,650],{"class":649},[640,1763,653],{"class":649},[640,1765,657],{"class":656},[640,1767,660],{"class":649},[640,1769,663],{"class":656},[640,1771,667],{"class":666},[640,1773,1774,1776,1778,1780,1782,1784],{"class":642,"line":670},[640,1775,673],{"class":649},[640,1777,657],{"class":656},[640,1779,678],{"class":649},[640,1781,681],{"class":666},[640,1783,663],{"class":656},[640,1785,667],{"class":666},[640,1787,1788,1790,1792,1795,1797],{"class":642,"line":688},[640,1789,673],{"class":649},[640,1791,657],{"class":656},[640,1793,1794],{"class":649},"Content-Type: application\u002Fjson",[640,1796,663],{"class":656},[640,1798,667],{"class":666},[640,1800,1801,1804,1806,1809],{"class":642,"line":703},[640,1802,1803],{"class":649},"  -d",[640,1805,708],{"class":656},[640,1807,1808],{"class":649},"{\"fileUrl\":\"https:\u002F\u002Fpim.example.com\u002Fexport\u002F4711.pdf\",\"categoryPath\":\"Products\u002FPrice lists\"}",[640,1810,714],{"class":656},[433,1812,1813,1814,1817,1818,588],{},"The address has to be reachable from DDM over HTTP(S), and redirects are not followed. The file may be as large as an upload – the plan's maximum file size – and DDM writes it to disk as it arrives. The download may take up to 15 minutes. If it fails, the answer is ",[500,1815,1816],{},"422"," with the reason; if the file is too large, ",[500,1819,1820],{},"413",[433,1822,1823],{},"DDM never contacts cloud metadata addresses. On a hosted DDM, whoever runs it may also block addresses in private networks; the file then has to be reachable from outside.",[442,1825,1827],{"id":1826},"_4-change-and-delete","4. Change and delete",[1829,1830,1831,1864],"ul",{},[1832,1833,1834,1837,1838,1840,1841,1843,1844,1847,1848,1850,1851,1840,1854,1840,1857,1840,1859,1847,1861,1863],"li",{},[500,1835,1836],{},"PATCH \u002Fdocuments\u002Fref\u002F{ref}"," changes ",[500,1839,1379],{},", ",[500,1842,1398],{}," (",[500,1845,1846],{},"archived"," or ",[500,1849,1407],{},"), ",[500,1852,1853],{},"shareable",[500,1855,1856],{},"highlighted",[500,1858,1418],{},[500,1860,1448],{},[500,1862,1496],{}," without sending the file again.",[1832,1865,1866,1869,1870,588],{},[500,1867,1868],{},"DELETE \u002Fdocuments\u002Fref\u002F{ref}"," deletes the document, exactly as deleting it in the CMS would. A document under a retention hold, or in a running approval, is refused with ",[500,1871,1872],{},"409",[630,1874,1876],{"className":632,"code":1875,"language":635,"meta":636,"style":636},"curl -X PATCH \"https:\u002F\u002Fddm.example.com\u002Fapi\u002Fext\u002Fv1\u002Fdocuments\u002Fref\u002FPIM-4711\" \\\n  -H \"Authorization: Bearer $DDM_API_KEY\" -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"status\":\"archived\"}'\n",[500,1877,1878,1895,1918],{"__ignoreMap":636},[640,1879,1880,1882,1884,1887,1889,1891,1893],{"class":642,"line":643},[640,1881,634],{"class":646},[640,1883,650],{"class":649},[640,1885,1886],{"class":649}," PATCH",[640,1888,657],{"class":656},[640,1890,660],{"class":649},[640,1892,663],{"class":656},[640,1894,667],{"class":666},[640,1896,1897,1899,1901,1903,1905,1907,1910,1912,1914,1916],{"class":642,"line":670},[640,1898,673],{"class":649},[640,1900,657],{"class":656},[640,1902,678],{"class":649},[640,1904,681],{"class":666},[640,1906,663],{"class":656},[640,1908,1909],{"class":649}," -H",[640,1911,657],{"class":656},[640,1913,1794],{"class":649},[640,1915,663],{"class":656},[640,1917,667],{"class":666},[640,1919,1920,1922,1924,1927],{"class":642,"line":688},[640,1921,1803],{"class":649},[640,1923,708],{"class":656},[640,1925,1926],{"class":649},"{\"status\":\"archived\"}",[640,1928,714],{"class":656},[442,1930,1932],{"id":1931},"_5-categories-if-you-manage-them-yourself","5. Categories, if you manage them yourself",[433,1934,1935,1936,1939,1940,1943],{},"If the other system has its own tree, push it ",[437,1937,1938],{},"top down"," by reference. ",[500,1941,1942],{},"parentRef"," names the parent by its reference:",[630,1945,1947],{"className":632,"code":1946,"language":635,"meta":636,"style":636},"curl -X PUT \"https:\u002F\u002Fddm.example.com\u002Fapi\u002Fext\u002Fv1\u002Fcategories\u002Fref\u002FCAT-10\" \\\n  -H \"Authorization: Bearer $DDM_API_KEY\" -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"name\":\"Products\"}'\n\ncurl -X PUT \"https:\u002F\u002Fddm.example.com\u002Fapi\u002Fext\u002Fv1\u002Fcategories\u002Fref\u002FCAT-11\" \\\n  -H \"Authorization: Bearer $DDM_API_KEY\" -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"name\":\"Price lists\",\"parentRef\":\"CAT-10\",\"titles\":{\"DE\":\"Preislisten\",\"AT\":\"Preislisten\"}}'\n",[500,1948,1949,1966,1988,1999,2003,2020,2042],{"__ignoreMap":636},[640,1950,1951,1953,1955,1957,1959,1962,1964],{"class":642,"line":643},[640,1952,634],{"class":646},[640,1954,650],{"class":649},[640,1956,653],{"class":649},[640,1958,657],{"class":656},[640,1960,1961],{"class":649},"https:\u002F\u002Fddm.example.com\u002Fapi\u002Fext\u002Fv1\u002Fcategories\u002Fref\u002FCAT-10",[640,1963,663],{"class":656},[640,1965,667],{"class":666},[640,1967,1968,1970,1972,1974,1976,1978,1980,1982,1984,1986],{"class":642,"line":670},[640,1969,673],{"class":649},[640,1971,657],{"class":656},[640,1973,678],{"class":649},[640,1975,681],{"class":666},[640,1977,663],{"class":656},[640,1979,1909],{"class":649},[640,1981,657],{"class":656},[640,1983,1794],{"class":649},[640,1985,663],{"class":656},[640,1987,667],{"class":666},[640,1989,1990,1992,1994,1997],{"class":642,"line":688},[640,1991,1803],{"class":649},[640,1993,708],{"class":656},[640,1995,1996],{"class":649},"{\"name\":\"Products\"}",[640,1998,714],{"class":656},[640,2000,2001],{"class":642,"line":703},[640,2002,753],{"emptyLinePlaceholder":752},[640,2004,2005,2007,2009,2011,2013,2016,2018],{"class":642,"line":861},[640,2006,634],{"class":646},[640,2008,650],{"class":649},[640,2010,653],{"class":649},[640,2012,657],{"class":656},[640,2014,2015],{"class":649},"https:\u002F\u002Fddm.example.com\u002Fapi\u002Fext\u002Fv1\u002Fcategories\u002Fref\u002FCAT-11",[640,2017,663],{"class":656},[640,2019,667],{"class":666},[640,2021,2022,2024,2026,2028,2030,2032,2034,2036,2038,2040],{"class":642,"line":893},[640,2023,673],{"class":649},[640,2025,657],{"class":656},[640,2027,678],{"class":649},[640,2029,681],{"class":666},[640,2031,663],{"class":656},[640,2033,1909],{"class":649},[640,2035,657],{"class":656},[640,2037,1794],{"class":649},[640,2039,663],{"class":656},[640,2041,667],{"class":666},[640,2043,2044,2046,2048,2051],{"class":642,"line":911},[640,2045,1803],{"class":649},[640,2047,708],{"class":656},[640,2049,2050],{"class":649},"{\"name\":\"Price lists\",\"parentRef\":\"CAT-10\",\"titles\":{\"DE\":\"Preislisten\",\"AT\":\"Preislisten\"}}",[640,2052,714],{"class":656},[433,2054,2055,2056,1843,2058,2061,2062,588],{},"Then file documents with ",[500,2057,1496],{},[500,2059,2060],{},"PATCH","), or set the push source's category mapping to ",[495,2063,514],{},[442,2065,2067],{"id":2066},"what-happens-after-a-push","What happens after a push",[433,2069,2070],{},"A pushed document is a document like any other:",[1829,2072,2073,2093,2100,2107],{},[1832,2074,2075,2076,2079,2080,2083,2084,2087,2088,2092],{},"It starts with the organisation's ",[437,2077,2078],{},"default status for uploads"," – or the status the push source sets under ",[437,2081,2082],{},"Status of new documents",". If the source is ",[437,2085,2086],{},"trusted",", its documents and new versions are approved at once (",[593,2089,2091],{"href":2090},"\u002Fen\u002Fexternal-sources\u002Foverview#trusted-sources","more",").",[1832,2094,2095,2096,2099],{},"New bytes on a document ",[437,2097,2098],{},"under review"," end that review, as an upload in the CMS does.",[1832,2101,2102,2103,2106],{},"People who worked on it get the usual ",[437,2104,2105],{},"\"New version\""," e-mail.",[1832,2108,2109,2110,2113],{},"With ",[495,2111,2112],{},"Distribute only after approval",", readers see it once it is approved.",[2115,2116,2117,2118,588],"warning",{},"The API never deletes on its own. A document that disappears from the other system stays in DDM until something calls ",[500,2119,2120],{},"DELETE",[2122,2123,2124],"style",{},"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 .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}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);}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":636,"searchDepth":670,"depth":670,"links":2126},[2127,2128,2129,2134,2135,2136],{"id":444,"depth":670,"text":445},{"id":598,"depth":670,"text":599},{"id":614,"depth":670,"text":615,"children":2130},[2131,2133],{"id":1663,"depth":688,"text":2132},"The details (metadata)",{"id":1742,"depth":688,"text":1743},{"id":1826,"depth":670,"text":1827},{"id":1931,"depth":670,"text":1932},{"id":2066,"depth":670,"text":2067},"Step by step – a push source, a key, and documents sent by your own references, as uploads or from a URL.","md",null,{},{"icon":331},{"title":328,"description":2137},"azhXQZZClEttdodk0FQiKAGVtVxqlYkmICqsqGEgrzs",[2145,2147],{"title":323,"path":324,"stem":325,"description":2146,"icon":326,"children":-1},"Formats, references, paging, change feeds, files, limits and errors – what every endpoint has in common.",{"title":333,"path":334,"stem":335,"description":2148,"icon":336,"children":-1},"Step by step – an export script that copies DDM's documents to another system and keeps it in step.",1793617721934]