Drafts and Records - Turn-key research data management repository

<!doctype html> <html lang="en" class="no-js"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width,initial-scale=1"> <link rel="canonical" href="https://inveniordm.docs.cern.ch/reference/rest_api_drafts_records/"> <link rel="prev" href="../rest_api_communities/"> <link rel="next" href="../rest_api_groups/"> <link rel="icon" href="../../images/favicon.svg"> <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.40"> <title>Drafts and Records - Turn-key research data management repository</title> <link rel="stylesheet" href="../../assets/stylesheets/main.8c3ca2c6.min.css"> <link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.min.css"> <link rel="stylesheet" href="../../stylesheets/extra.css"> <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script> </head> <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="custom"> <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off"> <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off"> <label class="md-overlay" for="__drawer"></label> <div data-md-component="skip"> <a href="#drafts-and-records" class="md-skip"> Skip to content </a> </div> <div data-md-component="announce"> </div> <header class="md-header" data-md-component="header"> <nav class="md-header__inner md-grid" aria-label="Header"> <a href="../.." title="Turn-key research data management repository" class="md-header__button md-logo" aria-label="Turn-key research data management repository" data-md-component="logo"> <img src="../../images/logo-rdm.png" alt="logo"> </a> <label class="md-header__button md-icon" for="__drawer"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class="md-header__title" data-md-component="header-title"> <div class="md-header__ellipsis"> <div class="md-header__topic"> Turn-key research data management repository </div> <div class="md-header__topic" data-md-component="header-topic"> Drafts and Records </div> </div> </div> <form class="md-header__option" data-md-component="palette"> <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_0"> <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="black" data-md-color-accent="orange" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_1"> <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> </form> <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script> <label class="md-header__button md-icon" for="__search"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class="md-search" data-md-component="search" role="dialog"> <label class="md-search__overlay" for="__search"></label> <div class="md-search__inner" role="search"> <form class="md-search__form" name="search"> <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required> <label class="md-search__icon md-icon" for="__search"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class="md-search__options" aria-label="Search"> <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class="md-search__output"> <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix> <div class="md-search-result" data-md-component="search-result"> <div class="md-search-result__meta"> Initializing search </div> <ol class="md-search-result__list" role="presentation"></ol> </div> </div> </div> </div> </div> <div class="md-header__source"> <a href="https://github.com/inveniosoftware/docs-invenio-rdm" title="Go to repository" class="md-source" data-md-component="source"> <div class="md-source__icon md-icon"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class="md-source__repository"> GitHub </div> </a> </div> </nav> </header> <div class="md-container" data-md-component="container"> <nav class="md-tabs" aria-label="Tabs" data-md-component="tabs"> <div class="md-grid"> <ul class="md-tabs__list"> <li class="md-tabs__item"> <a href="../.." class="md-tabs__link"> Home </a> </li> <li class="md-tabs__item"> <a href="../../features/" class="md-tabs__link"> Features </a> </li> <li class="md-tabs__item"> <a href="../../install/" class="md-tabs__link"> Install </a> </li> <li class="md-tabs__item"> <a href="../../customize/" class="md-tabs__link"> Customize </a> </li> <li class="md-tabs__item"> <a href="../../develop/" class="md-tabs__link"> Develop </a> </li> <li class="md-tabs__item"> <a href="../../deploy/" class="md-tabs__link"> Deploy </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href="../" class="md-tabs__link"> Reference </a> </li> <li class="md-tabs__item"> <a href="../../releases/" class="md-tabs__link"> Releases </a> </li> <li class="md-tabs__item"> <a href="../../maintenance/" class="md-tabs__link"> Maintainers </a> </li> <li class="md-tabs__item"> <a href="../../contribute/" class="md-tabs__link"> Onboard & Contribute </a> </li> </ul> </div> </nav> <main class="md-main" data-md-component="main"> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" > <div class="md-sidebar__scrollwrap"> <div class="md-sidebar__inner"> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0"> <label class="md-nav__title" for="__drawer"> <a href="../.." title="Turn-key research data management repository" class="md-nav__button md-logo" aria-label="Turn-key research data management repository" data-md-component="logo"> <img src="../../images/logo-rdm.png" alt="logo"> </a> Turn-key research data management repository </label> <div class="md-nav__source"> <a href="https://github.com/inveniosoftware/docs-invenio-rdm" title="Go to repository" class="md-source" data-md-component="source"> <div class="md-source__icon md-icon"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class="md-source__repository"> GitHub </div> </a> </div> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../.." class="md-nav__link"> Home </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" > <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0"> Features </label> <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_2"> Features </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../features/" class="md-nav__link"> Overview </a> </li> <li class="md-nav__item"> <a href="../../features/ux/" class="md-nav__link"> Beautiful UX </a> </li> <li class="md-nav__item"> <a href="../../features/scalable/" class="md-nav__link"> Highly scalable </a> </li> <li class="md-nav__item"> <a href="../../features/customization/" class="md-nav__link"> Customizable </a> </li> <li class="md-nav__item"> <a href="../../features/interoperable/" class="md-nav__link"> Interoperable </a> </li> <li class="md-nav__item"> <a href="../../features/powerful/" class="md-nav__link"> Powerful </a> </li> <li class="md-nav__item"> <a href="../../features/secure/" class="md-nav__link"> Secure </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_8" > <label class="md-nav__link" for="__nav_2_8" id="__nav_2_8_label" tabindex="0"> Features walk-through </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_8_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_2_8"> Features walk-through </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../features/features-walk-through/" class="md-nav__link"> Features overview </a> </li> <li class="md-nav__item"> <a href="../../features/features-walk-through/banners/" class="md-nav__link"> Site banners </a> </li> <li class="md-nav__item"> <a href="../../features/features-walk-through/notifications/" class="md-nav__link"> Notifications </a> </li> <li class="md-nav__item"> <a href="../../features/features-walk-through/access_requests/" class="md-nav__link"> Access requests </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" > <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0"> Install </label> <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_3"> Install </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../install/" class="md-nav__link"> Quick start </a> </li> <li class="md-nav__item"> <a href="../../install/requirements/" class="md-nav__link"> System requirements </a> </li> <li class="md-nav__item"> <a href="../../install/cli/" class="md-nav__link"> Install CLI </a> </li> <li class="md-nav__item"> <a href="../../install/scaffold/" class="md-nav__link"> Scaffold </a> </li> <li class="md-nav__item"> <a href="../../install/build-setup-run/" class="md-nav__link"> Build, setup & run </a> </li> <li class="md-nav__item"> <a href="../../install/configuration/" class="md-nav__link"> Configure </a> </li> <li class="md-nav__item"> <a href="../../install/run/" class="md-nav__link"> Use </a> </li> <li class="md-nav__item"> <a href="../../install/migrate/" class="md-nav__link"> Migrate </a> </li> <li class="md-nav__item"> <a href="../../install/destroy/" class="md-nav__link"> Destroy </a> </li> <li class="md-nav__item"> <a href="../../install/troubleshoot/" class="md-nav__link"> Troubleshooting </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" > <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0"> Customize </label> <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_4"> Customize </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../customize/" class="md-nav__link"> Overview </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_2" > <label class="md-nav__link" for="__nav_4_2" id="__nav_4_2_label" tabindex="0"> Look-and-feel </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_2_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_4_2"> Look-and-feel </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../customize/look-and-feel/" class="md-nav__link"> Overview </a> </li> <li class="md-nav__item"> <a href="../../customize/look-and-feel/logo/" class="md-nav__link"> Change logo </a> </li> <li class="md-nav__item"> <a href="../../customize/look-and-feel/templates/" class="md-nav__link"> Change templates </a> </li> <li class="md-nav__item"> <a href="../../customize/look-and-feel/theme/" class="md-nav__link"> Change theme </a> </li> <li class="md-nav__item"> <a href="../../customize/look-and-feel/font/" class="md-nav__link"> Change font </a> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="../../customize/authentication/" class="md-nav__link"> Authentication </a> </li> <li class="md-nav__item"> <a href="../../customize/emails/" class="md-nav__link"> Sending emails </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_5" > <label class="md-nav__link" for="__nav_4_5" id="__nav_4_5_label" tabindex="0"> Search </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_5_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_4_5"> Search </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../customize/search/" class="md-nav__link"> Change facets/sorting </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_6" > <label class="md-nav__link" for="__nav_4_6" id="__nav_4_6_label" tabindex="0"> Vocabularies </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_6_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_4_6"> Vocabularies </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../customize/vocabularies/" class="md-nav__link"> Overview </a> </li> <li class="md-nav__item"> <a href="../../customize/vocabularies/resource_types/" class="md-nav__link"> Resource types </a> </li> <li class="md-nav__item"> <a href="../../customize/vocabularies/affiliations/" class="md-nav__link"> Affiliations </a> </li> <li class="md-nav__item"> <a href="../../customize/vocabularies/names/" class="md-nav__link"> Names </a> </li> <li class="md-nav__item"> <a href="../../customize/vocabularies/funding/" class="md-nav__link"> Funding </a> </li> <li class="md-nav__item"> <a href="../../customize/vocabularies/subjects/" class="md-nav__link"> Subjects </a> </li> <li class="md-nav__item"> <a href="../../customize/vocabularies/users/" class="md-nav__link"> Users </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_7" > <label class="md-nav__link" for="__nav_4_7" id="__nav_4_7_label" tabindex="0"> Metadata </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_7_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_4_7"> Metadata </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../customize/metadata/optional_fields/" class="md-nav__link"> Optional metadata </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_7_2" > <label class="md-nav__link" for="__nav_4_7_2" id="__nav_4_7_2_label" tabindex="0"> Custom fields </label> <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_4_7_2_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_4_7_2"> Custom fields </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../customize/metadata/custom_fields/records/" class="md-nav__link"> Add fields to records </a> </li> <li class="md-nav__item"> <a href="../../customize/metadata/custom_fields/communities/" class="md-nav__link"> Add fields to communities </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="../../customize/record_landing_page/" class="md-nav__link"> Record landing page </a> </li> <li class="md-nav__item"> <a href="../../customize/static_pages/" class="md-nav__link"> Static pages </a> </li> <li class="md-nav__item"> <a href="../../customize/dois/" class="md-nav__link"> DOI registration </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_11" > <label class="md-nav__link" for="__nav_4_11" id="__nav_4_11_label" tabindex="0"> Other PIDs integrations </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_11_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_4_11"> Other PIDs integrations </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../customize/other-pids/urns/" class="md-nav__link"> DNB URNs </a> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="../../customize/s3/" class="md-nav__link"> Storage </a> </li> <li class="md-nav__item"> <a href="../../customize/upload_limits/" class="md-nav__link"> Upload Limits </a> </li> <li class="md-nav__item"> <a href="../../customize/metadata_only/" class="md-nav__link"> Metadata-only records </a> </li> <li class="md-nav__item"> <a href="../../customize/Logging/" class="md-nav__link"> Logging </a> </li> <li class="md-nav__item"> <a href="../../customize/i18n-and-l10n/" class="md-nav__link"> Internationalisation (i18n) and Localisation (l10n) </a> </li> <li class="md-nav__item"> <a href="../../customize/notifications/" class="md-nav__link"> Notifications </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" > <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0"> Develop </label> <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_5"> Develop </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../develop/" class="md-nav__link"> Overview </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" > <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0"> Getting started </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_5_2"> Getting started </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../develop/getting-started/source-code/" class="md-nav__link"> Source code </a> </li> <li class="md-nav__item"> <a href="../../develop/getting-started/package-development/" class="md-nav__link"> Package development </a> </li> <li class="md-nav__item"> <a href="../../develop/getting-started/instance-development/" class="md-nav__link"> Instance development </a> </li> <li class="md-nav__item"> <a href="../../develop/getting-started/debugging/" class="md-nav__link"> Debugging </a> </li> <li class="md-nav__item"> <a href="../../develop/getting-started/code-style/" class="md-nav__link"> Coding style </a> </li> <li class="md-nav__item"> <a href="../../develop/getting-started/virtualenvs/" class="md-nav__link"> Virtual environments </a> </li> <li class="md-nav__item"> <a href="../../develop/getting-started/help/" class="md-nav__link"> Getting help </a> </li> <li class="md-nav__item"> <a href="../../develop/process/" class="md-nav__link"> Development process </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" > <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0"> Best practices </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_5_3"> Best practices </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../develop/best-practices/accessibility/" class="md-nav__link"> Accessibility (a11y) </a> </li> <li class="md-nav__item"> <a href="../../develop/best-practices/commits/" class="md-nav__link"> Commits, PRs & reviews </a> </li> <li class="md-nav__item"> <a href="../../develop/best-practices/css-js/" class="md-nav__link"> CSS/JavaScript </a> </li> <li class="md-nav__item"> <a href="../../develop/best-practices/react/" class="md-nav__link"> React </a> </li> <li class="md-nav__item"> <a href="../../develop/best-practices/ui/" class="md-nav__link"> User interface </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" > <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0"> Topic guides </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_5_4"> Topic guides </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../develop/topics/resource/" class="md-nav__link"> Building resources </a> </li> <li class="md-nav__item"> <a href="../../develop/topics/service/" class="md-nav__link"> Building services </a> </li> <li class="md-nav__item"> <a href="../../develop/topics/serializers/" class="md-nav__link"> Building serializers </a> </li> <li class="md-nav__item"> <a href="../../develop/topics/uow/" class="md-nav__link"> Grouping atomic operations </a> </li> <li class="md-nav__item"> <a href="../../develop/topics/validation/" class="md-nav__link"> Sanitize input data </a> </li> <li class="md-nav__item"> <a href="../../develop/topics/theming/" class="md-nav__link"> Theming </a> </li> <li class="md-nav__item"> <a href="../../develop/topics/administration_panel/" class="md-nav__link"> Administration panel </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" > <label class="md-nav__link" for="__nav_5_5" id="__nav_5_5_label" tabindex="0"> How-to guides </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_5_5"> How-to guides </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../develop/howtos/i18n/" class="md-nav__link"> Translation (i18n) </a> </li> <li class="md-nav__item"> <a href="../../develop/howtos/custom_fields/" class="md-nav__link"> Create a new custom field </a> </li> <li class="md-nav__item"> <a href="../../develop/howtos/custom_code/" class="md-nav__link"> Create custom code and views </a> </li> <li class="md-nav__item"> <a href="../../develop/howtos/add_javascript/" class="md-nav__link"> Add JavaScript </a> </li> <li class="md-nav__item"> <a href="../../develop/howtos/override_components/" class="md-nav__link"> Override UI React components </a> </li> <li class="md-nav__item"> <a href="../../develop/howtos/search_terms_migration/" class="md-nav__link"> Create search terms mappings </a> </li> <li class="md-nav__item"> <a href="../../develop/howtos/alembic/" class="md-nav__link"> Create a database migration </a> </li> <li class="md-nav__item"> <a href="../../develop/howtos/security-fix/" class="md-nav__link"> Fix a vulnerability </a> </li> <li class="md-nav__item"> <a href="../../develop/howtos/dev_email/" class="md-nav__link"> Test emails locally </a> </li> <li class="md-nav__item"> <a href="../../develop/howtos/route_migration/" class="md-nav__link"> Migrate legacy routes </a> </li> <li class="md-nav__item"> <a href="../../develop/howtos/backup_search_indices/" class="md-nav__link"> Back up search indices </a> </li> <li class="md-nav__item"> <a href="../../develop/howtos/restrict_access/" class="md-nav__link"> Restrict access to pages </a> </li> <li class="md-nav__item"> <a href="../../develop/howtos/notifications/" class="md-nav__link"> Create and configure notifications </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_6" > <label class="md-nav__link" for="__nav_5_6" id="__nav_5_6_label" tabindex="0"> Architecture </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_6_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_5_6"> Architecture </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../develop/architecture/" class="md-nav__link"> Introduction </a> </li> <li class="md-nav__item"> <a href="../../develop/architecture/infrastructure/" class="md-nav__link"> Infrastructure </a> </li> <li class="md-nav__item"> <a href="../../develop/architecture/software/" class="md-nav__link"> Software </a> </li> <li class="md-nav__item"> <a href="../../develop/architecture/runtime/" class="md-nav__link"> Runtime </a> </li> <li class="md-nav__item"> <a href="../../develop/architecture/requests/" class="md-nav__link"> Requests </a> </li> <li class="md-nav__item"> <a href="../../develop/architecture/communities/" class="md-nav__link"> Communities </a> </li> <li class="md-nav__item"> <a href="../../develop/architecture/records/" class="md-nav__link"> Records </a> </li> <li class="md-nav__item"> <a href="../../develop/architecture/event_handling/" class="md-nav__link"> Event handling </a> </li> <li class="md-nav__item"> <a href="../../develop/architecture/notifications/" class="md-nav__link"> Notifications </a> </li> <li class="md-nav__item"> <a href="../../develop/architecture/reading/" class="md-nav__link"> Recommended reading </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_7" > <label class="md-nav__link" for="__nav_5_7" id="__nav_5_7_label" tabindex="0"> Concepts </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_7_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_5_7"> Concepts </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../develop/concepts/concurrency-control/" class="md-nav__link"> Optimistic concurrency control </a> </li> <li class="md-nav__item"> <a href="../../develop/concepts/transactions/" class="md-nav__link"> Database transaction management </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="../../deploy/" class="md-nav__link"> Deploy </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" checked> <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex=""> Reference </label> <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="true"> <label class="md-nav__title" for="__nav_7"> Reference </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../" class="md-nav__link"> Overview </a> </li> <li class="md-nav__item"> <a href="../cli/" class="md-nav__link"> CLI </a> </li> <li class="md-nav__item"> <a href="../configuration/" class="md-nav__link"> Configuration </a> </li> <li class="md-nav__item"> <a href="../metadata/" class="md-nav__link"> Metadata </a> </li> <li class="md-nav__item"> <a href="../metadata/optional_metadata/" class="md-nav__link"> Optional metadata </a> </li> <li class="md-nav__item"> <a href="../oai_pmh/" class="md-nav__link"> OAI-PMH </a> </li> <li class="md-nav__item"> <a href="../export_formats/" class="md-nav__link"> Export formats </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7_8" checked> <label class="md-nav__link" for="__nav_7_8" id="__nav_7_8_label" tabindex="0"> REST API </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_7_8_label" aria-expanded="true"> <label class="md-nav__title" for="__nav_7_8"> REST API </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../rest_api_index/" class="md-nav__link"> Overview </a> </li> <li class="md-nav__item"> <a href="../rest_api_quickstart/" class="md-nav__link"> Quickstart </a> </li> <li class="md-nav__item"> <a href="../rest_api_communities/" class="md-nav__link"> Communities </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc"> <label class="md-nav__link md-nav__link--active" for="__toc"> Drafts and Records </label> <a href="./" class="md-nav__link md-nav__link--active"> Drafts and Records </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class="md-nav__title" for="__toc"> Table of contents </label> <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix> <li class="md-nav__item"> <a href="#drafts" class="md-nav__link"> Drafts </a> <nav class="md-nav" aria-label="Drafts"> <ul class="md-nav__list"> <li class="md-nav__item"> <a href="#create-a-draft-record" class="md-nav__link"> Create a draft record </a> <nav class="md-nav" aria-label="Create a draft record"> <ul class="md-nav__list"> <li class="md-nav__item"> <a href="#files-options" class="md-nav__link"> Files Options </a> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="#get-a-draft-record" class="md-nav__link"> Get a draft record </a> </li> <li class="md-nav__item"> <a href="#update-a-draft-record" class="md-nav__link"> Update a draft record </a> </li> <li class="md-nav__item"> <a href="#publish-a-draft-record" class="md-nav__link"> Publish a draft record </a> </li> <li class="md-nav__item"> <a href="#edit-a-published-record-create-a-draft-record-from-a-published-record" class="md-nav__link"> Edit a published record (Create a draft record from a published record) </a> </li> <li class="md-nav__item"> <a href="#deletediscard-a-draft-record" class="md-nav__link"> Delete/discard a draft record </a> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="#draft-files" class="md-nav__link"> Draft files </a> <nav class="md-nav" aria-label="Draft files"> <ul class="md-nav__list"> <li class="md-nav__item"> <a href="#list-a-drafts-files" class="md-nav__link"> List a draft's files </a> </li> <li class="md-nav__item"> <a href="#start-draft-file-uploads" class="md-nav__link"> Start draft file upload(s) </a> </li> <li class="md-nav__item"> <a href="#upload-a-draft-files-content" class="md-nav__link"> Upload a draft file's content </a> </li> <li class="md-nav__item"> <a href="#complete-a-draft-file-upload" class="md-nav__link"> Complete a draft file upload </a> </li> <li class="md-nav__item"> <a href="#get-a-draft-files-metadata" class="md-nav__link"> Get a draft file's metadata </a> </li> <li class="md-nav__item"> <a href="#download-a-draft-file" class="md-nav__link"> Download a draft file </a> </li> <li class="md-nav__item"> <a href="#delete-a-draft-file" class="md-nav__link"> Delete a draft file </a> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="#records" class="md-nav__link"> Records </a> <nav class="md-nav" aria-label="Records"> <ul class="md-nav__list"> <li class="md-nav__item"> <a href="#get-a-record" class="md-nav__link"> Get a record </a> </li> <li class="md-nav__item"> <a href="#search-records" class="md-nav__link"> Search records </a> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="#record-files" class="md-nav__link"> Record files </a> <nav class="md-nav" aria-label="Record files"> <ul class="md-nav__list"> <li class="md-nav__item"> <a href="#list-a-records-files" class="md-nav__link"> List a record's files </a> </li> <li class="md-nav__item"> <a href="#get-a-record-files-metadata" class="md-nav__link"> Get a record file's metadata </a> </li> <li class="md-nav__item"> <a href="#download-a-record-file" class="md-nav__link"> Download a record file </a> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="#versions" class="md-nav__link"> Versions </a> <nav class="md-nav" aria-label="Versions"> <ul class="md-nav__list"> <li class="md-nav__item"> <a href="#create-a-new-version" class="md-nav__link"> Create a new version </a> </li> <li class="md-nav__item"> <a href="#link-files-from-previous-version" class="md-nav__link"> Link files from previous version </a> </li> <li class="md-nav__item"> <a href="#get-all-versions" class="md-nav__link"> Get all versions </a> </li> <li class="md-nav__item"> <a href="#get-latest-version" class="md-nav__link"> Get latest version </a> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="#access-links" class="md-nav__link"> Access links </a> <nav class="md-nav" aria-label="Access links"> <ul class="md-nav__list"> <li class="md-nav__item"> <a href="#create-an-access-link" class="md-nav__link"> Create an access link </a> </li> <li class="md-nav__item"> <a href="#get-an-access-link" class="md-nav__link"> Get an access link </a> </li> <li class="md-nav__item"> <a href="#update-an-access-link" class="md-nav__link"> Update an access link </a> </li> <li class="md-nav__item"> <a href="#delete-an-access-link" class="md-nav__link"> Delete an access link </a> </li> <li class="md-nav__item"> <a href="#list-access-links" class="md-nav__link"> List access links </a> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="#user-records" class="md-nav__link"> User Records </a> <nav class="md-nav" aria-label="User Records"> <ul class="md-nav__list"> <li class="md-nav__item"> <a href="#list-your-draft-and-published-records" class="md-nav__link"> List your draft and published records </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="../rest_api_groups/" class="md-nav__link"> Groups </a> </li> <li class="md-nav__item"> <a href="../rest_api_members/" class="md-nav__link"> Members </a> </li> <li class="md-nav__item"> <a href="../rest_api_requests/" class="md-nav__link"> Requests </a> </li> <li class="md-nav__item"> <a href="../rest_api_users/" class="md-nav__link"> Users </a> </li> <li class="md-nav__item"> <a href="../rest_api_reviews/" class="md-nav__link"> Reviews </a> </li> <li class="md-nav__item"> <a href="../rest_api_vocabularies/" class="md-nav__link"> Vocabularies </a> </li> <li class="md-nav__item"> <a href="../rest_api_names/" class="md-nav__link"> Names </a> </li> <li class="md-nav__item"> <a href="../rest_api_funders/" class="md-nav__link"> Funders </a> </li> <li class="md-nav__item"> <a href="../rest_api_awards/" class="md-nav__link"> Awards </a> </li> <li class="md-nav__item"> <a href="../rest_api_oaipmh_sets/" class="md-nav__link"> OAI-PMH Sets </a> </li> <li class="md-nav__item"> <a href="../rest_api_statistics/" class="md-nav__link"> Statistics </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7_9" > <label class="md-nav__link" for="__nav_7_9" id="__nav_7_9_label" tabindex="0"> Custom fields </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_7_9_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_7_9"> Custom fields </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../custom_fields/widgets/" class="md-nav__link"> UI widgets </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7_10" > <label class="md-nav__link" for="__nav_7_10" id="__nav_7_10_label" tabindex="0"> Administration </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_7_10_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_7_10"> Administration </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../administration_reference/" class="md-nav__link"> Reference </a> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="../file_storage/" class="md-nav__link"> File storage </a> </li> <li class="md-nav__item"> <a href="../statistics/" class="md-nav__link"> Usage statistics </a> </li> <li class="md-nav__item"> <a href="../notifications/" class="md-nav__link"> Notifications </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" > <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0"> Releases </label> <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_8"> Releases </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../releases/" class="md-nav__link"> Overview </a> </li> <li class="md-nav__item"> <a href="../../releases/maintenance-policy/" class="md-nav__link"> Maintenance policy </a> </li> <li class="md-nav__item"> <a href="../../releases/upgrade-policy/" class="md-nav__link"> Upgrade policy </a> </li> <li class="md-nav__item"> <a href="../../releases/security-policy/" class="md-nav__link"> Security policy </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_5" > <label class="md-nav__link" for="__nav_8_5" id="__nav_8_5_label" tabindex="0"> Version v12.0 LTS </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_5_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_8_5"> Version v12.0 LTS </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../releases/v12/version-v12.0.0/" class="md-nav__link"> Release Notes v12.0 </a> </li> <li class="md-nav__item"> <a href="../../releases/v12/upgrade-v12.0/" class="md-nav__link"> Upgrade from v11 to v12 </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_6" > <label class="md-nav__link" for="__nav_8_6" id="__nav_8_6_label" tabindex="0"> Version v11.0 STS </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_6_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_8_6"> Version v11.0 STS </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../releases/v11/version-v11.0.0/" class="md-nav__link"> Release Notes v11.0 </a> </li> <li class="md-nav__item"> <a href="../../releases/v11/upgrade-v11.0/" class="md-nav__link"> Upgrade from v10 to v11 </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_7" > <label class="md-nav__link" for="__nav_8_7" id="__nav_8_7_label" tabindex="0"> Version v9.1 LTS </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_7_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_8_7"> Version v9.1 LTS </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../releases/v9/version-v9.1.0/" class="md-nav__link"> Release Notes v9.1 </a> </li> <li class="md-nav__item"> <a href="../../releases/v9/version-v9.0.0/" class="md-nav__link"> Release Notes v9.0 </a> </li> <li class="md-nav__item"> <a href="../../releases/migrate-docker-images/" class="md-nav__link"> Migrate Docker images </a> </li> <li class="md-nav__item"> <a href="../../releases/v9/migrate-opensearch-v9/" class="md-nav__link"> Migrate v9 to OpenSearch </a> </li> <li class="md-nav__item"> <a href="../../releases/v9/upgrade-v9.0/" class="md-nav__link"> Upgrade from v8 to v9 </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_8" > <label class="md-nav__link" for="__nav_8_8" id="__nav_8_8_label" tabindex="0"> Legacy Versions </label> <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_8_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_8_8"> Legacy Versions </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_8_1" > <label class="md-nav__link" for="__nav_8_8_1" id="__nav_8_8_1_label" tabindex="0"> Version v10.1 </label> <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_8_8_1_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_8_8_1"> Version v10.1 </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../releases/v10/version-v10.1.0/" class="md-nav__link"> Release Notes v10.1 </a> </li> <li class="md-nav__item"> <a href="../../releases/v10/version-v10.0.0/" class="md-nav__link"> Release Notes v10.0 </a> </li> <li class="md-nav__item"> <a href="../../releases/v10/upgrade-v10.0/" class="md-nav__link"> Upgrade from v9 to v10 </a> </li> <li class="md-nav__item"> <a href="../../releases/migrate-docker-images/" class="md-nav__link"> Migrate Docker images </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_8_2" > <label class="md-nav__link" for="__nav_8_8_2" id="__nav_8_8_2_label" tabindex="0"> Version v8.0 </label> <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_8_8_2_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_8_8_2"> Version v8.0 </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../releases/v8/version-v8.0.0/" class="md-nav__link"> Release Notes v8.0 </a> </li> <li class="md-nav__item"> <a href="../../releases/v8/upgrade-v8.0/" class="md-nav__link"> Upgrade from v7 to v8 </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_8_3" > <label class="md-nav__link" for="__nav_8_8_3" id="__nav_8_8_3_label" tabindex="0"> Version v7.0 </label> <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_8_8_3_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_8_8_3"> Version v7.0 </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../releases/v7/version-v7.0.0/" class="md-nav__link"> Release Notes v7.0 </a> </li> <li class="md-nav__item"> <a href="../../releases/v7/upgrade-v7.0/" class="md-nav__link"> Upgrade from v6 to v7 </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_8_4" > <label class="md-nav__link" for="__nav_8_8_4" id="__nav_8_8_4_label" tabindex="0"> Version v6.0.5 </label> <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_8_8_4_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_8_8_4"> Version v6.0.5 </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../releases/v6/version-v6.0.5/" class="md-nav__link"> Release Notes v6.0.5 </a> </li> <li class="md-nav__item"> <a href="../../releases/v6/upgrade-v6.0.5/" class="md-nav__link"> Upgrade from v6.0.x to v6.0.5 </a> </li> <li class="md-nav__item"> <a href="../../releases/v6/version-v6.0.0/" class="md-nav__link"> Release Notes v6.0.0 </a> </li> <li class="md-nav__item"> <a href="../../releases/v6/upgrade-v6.0/" class="md-nav__link"> Upgrade from v4 to v6 </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_8_5" > <label class="md-nav__link" for="__nav_8_8_5" id="__nav_8_8_5_label" tabindex="0"> Version v5.0 </label> <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_8_8_5_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_8_8_5"> Version v5.0 </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../releases/v5/version-v5.0.0/" class="md-nav__link"> Release Notes v5.0 </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_8_6" > <label class="md-nav__link" for="__nav_8_8_6" id="__nav_8_8_6_label" tabindex="0"> Version v4.0 </label> <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_8_8_6_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_8_8_6"> Version v4.0 </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../releases/v4/version-v4.0.0/" class="md-nav__link"> Release Notes v4.0 </a> </li> <li class="md-nav__item"> <a href="../../releases/v4/upgrade-v4.0/" class="md-nav__link"> Upgrade from v3 to v4 </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_8_7" > <label class="md-nav__link" for="__nav_8_8_7" id="__nav_8_8_7_label" tabindex="0"> Version v3.0 </label> <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_8_8_7_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_8_8_7"> Version v3.0 </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../releases/v3/version-v3.0.0/" class="md-nav__link"> Release Notes v3.0 </a> </li> <li class="md-nav__item"> <a href="../../releases/v3/upgrade-v3.0/" class="md-nav__link"> Upgrade from v2 to v3 </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_8_8" > <label class="md-nav__link" for="__nav_8_8_8" id="__nav_8_8_8_label" tabindex="0"> Version v2.0 </label> <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_8_8_8_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_8_8_8"> Version v2.0 </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../releases/v2/version-v2.0.0/" class="md-nav__link"> Release Notes v2.0 </a> </li> <li class="md-nav__item"> <a href="../../releases/v2/upgrade-v2.0/" class="md-nav__link"> Upgrade from v1 to v2 </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_8_9" > <label class="md-nav__link" for="__nav_8_8_9" id="__nav_8_8_9_label" tabindex="0"> Version v1.0 </label> <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_8_8_9_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_8_8_9"> Version v1.0 </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../releases/v1/version-v1.0.0/" class="md-nav__link"> Release Notes v1.0 </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" > <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0"> Maintainers </label> <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_9"> Maintainers </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../maintenance/" class="md-nav__link"> Overview </a> </li> <li class="md-nav__item"> <a href="../../maintenance/newcomers/" class="md-nav__link"> Newcomers </a> </li> <li class="md-nav__item"> <a href="../../maintenance/board-workflow/" class="md-nav__link"> Sprintboard workflow </a> </li> <li class="md-nav__item"> <a href="../../maintenance/pr-community-board/" class="md-nav__link"> Community PR board </a> </li> <li class="md-nav__item"> <a href="../../maintenance/release-management/" class="md-nav__link"> Release management </a> </li> <li class="md-nav__item"> <a href="../../maintenance/modules/" class="md-nav__link"> Modules on GitHub </a> </li> <li class="md-nav__item"> <a href="../../maintenance/branch-management/" class="md-nav__link"> Branch management </a> </li> <li class="md-nav__item"> <a href="../../maintenance/demosite/" class="md-nav__link"> Demo site & docs </a> </li> <li class="md-nav__item"> <a href="../../maintenance/docker-images/" class="md-nav__link"> Docker images </a> </li> <li class="md-nav__item"> <a href="../../maintenance/rfcs/" class="md-nav__link"> RFCs </a> </li> <li class="md-nav__item"> <a href="../../maintenance/documentation/" class="md-nav__link"> Writing documentation </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_10" > <label class="md-nav__link" for="__nav_10" id="__nav_10_label" tabindex="0"> Onboard & Contribute </label> <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_10_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_10"> Onboard & Contribute </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../../contribute/" class="md-nav__link"> Overview </a> </li> <li class="md-nav__item"> <a href="../../contribute/onboarding/" class="md-nav__link"> Onboarding </a> </li> <li class="md-nav__item"> <a href="../../contribute/code-of-conduct/" class="md-nav__link"> Code of conduct </a> </li> <li class="md-nav__item"> <a href="../../contribute/copyright-policy/" class="md-nav__link"> Copyright policy </a> </li> <li class="md-nav__item"> <a href="../../contribute/roadmap/" class="md-nav__link"> Roadmap </a> </li> <li class="md-nav__item"> <a href="../../contribute/translators-guide/" class="md-nav__link"> Translators guide </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" > <div class="md-sidebar__scrollwrap"> <div class="md-sidebar__inner"> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class="md-nav__title" for="__toc"> Table of contents </label> <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix> <li class="md-nav__item"> <a href="#drafts" class="md-nav__link"> Drafts </a> <nav class="md-nav" aria-label="Drafts"> <ul class="md-nav__list"> <li class="md-nav__item"> <a href="#create-a-draft-record" class="md-nav__link"> Create a draft record </a> <nav class="md-nav" aria-label="Create a draft record"> <ul class="md-nav__list"> <li class="md-nav__item"> <a href="#files-options" class="md-nav__link"> Files Options </a> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="#get-a-draft-record" class="md-nav__link"> Get a draft record </a> </li> <li class="md-nav__item"> <a href="#update-a-draft-record" class="md-nav__link"> Update a draft record </a> </li> <li class="md-nav__item"> <a href="#publish-a-draft-record" class="md-nav__link"> Publish a draft record </a> </li> <li class="md-nav__item"> <a href="#edit-a-published-record-create-a-draft-record-from-a-published-record" class="md-nav__link"> Edit a published record (Create a draft record from a published record) </a> </li> <li class="md-nav__item"> <a href="#deletediscard-a-draft-record" class="md-nav__link"> Delete/discard a draft record </a> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="#draft-files" class="md-nav__link"> Draft files </a> <nav class="md-nav" aria-label="Draft files"> <ul class="md-nav__list"> <li class="md-nav__item"> <a href="#list-a-drafts-files" class="md-nav__link"> List a draft's files </a> </li> <li class="md-nav__item"> <a href="#start-draft-file-uploads" class="md-nav__link"> Start draft file upload(s) </a> </li> <li class="md-nav__item"> <a href="#upload-a-draft-files-content" class="md-nav__link"> Upload a draft file's content </a> </li> <li class="md-nav__item"> <a href="#complete-a-draft-file-upload" class="md-nav__link"> Complete a draft file upload </a> </li> <li class="md-nav__item"> <a href="#get-a-draft-files-metadata" class="md-nav__link"> Get a draft file's metadata </a> </li> <li class="md-nav__item"> <a href="#download-a-draft-file" class="md-nav__link"> Download a draft file </a> </li> <li class="md-nav__item"> <a href="#delete-a-draft-file" class="md-nav__link"> Delete a draft file </a> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="#records" class="md-nav__link"> Records </a> <nav class="md-nav" aria-label="Records"> <ul class="md-nav__list"> <li class="md-nav__item"> <a href="#get-a-record" class="md-nav__link"> Get a record </a> </li> <li class="md-nav__item"> <a href="#search-records" class="md-nav__link"> Search records </a> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="#record-files" class="md-nav__link"> Record files </a> <nav class="md-nav" aria-label="Record files"> <ul class="md-nav__list"> <li class="md-nav__item"> <a href="#list-a-records-files" class="md-nav__link"> List a record's files </a> </li> <li class="md-nav__item"> <a href="#get-a-record-files-metadata" class="md-nav__link"> Get a record file's metadata </a> </li> <li class="md-nav__item"> <a href="#download-a-record-file" class="md-nav__link"> Download a record file </a> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="#versions" class="md-nav__link"> Versions </a> <nav class="md-nav" aria-label="Versions"> <ul class="md-nav__list"> <li class="md-nav__item"> <a href="#create-a-new-version" class="md-nav__link"> Create a new version </a> </li> <li class="md-nav__item"> <a href="#link-files-from-previous-version" class="md-nav__link"> Link files from previous version </a> </li> <li class="md-nav__item"> <a href="#get-all-versions" class="md-nav__link"> Get all versions </a> </li> <li class="md-nav__item"> <a href="#get-latest-version" class="md-nav__link"> Get latest version </a> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="#access-links" class="md-nav__link"> Access links </a> <nav class="md-nav" aria-label="Access links"> <ul class="md-nav__list"> <li class="md-nav__item"> <a href="#create-an-access-link" class="md-nav__link"> Create an access link </a> </li> <li class="md-nav__item"> <a href="#get-an-access-link" class="md-nav__link"> Get an access link </a> </li> <li class="md-nav__item"> <a href="#update-an-access-link" class="md-nav__link"> Update an access link </a> </li> <li class="md-nav__item"> <a href="#delete-an-access-link" class="md-nav__link"> Delete an access link </a> </li> <li class="md-nav__item"> <a href="#list-access-links" class="md-nav__link"> List access links </a> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="#user-records" class="md-nav__link"> User Records </a> <nav class="md-nav" aria-label="User Records"> <ul class="md-nav__list"> <li class="md-nav__item"> <a href="#list-your-draft-and-published-records" class="md-nav__link"> List your draft and published records </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-content" data-md-component="content"> <article class="md-content__inner md-typeset"> <h1 id="drafts-and-records">Drafts and Records<a class="headerlink" href="#drafts-and-records" title="Permanent link">¶</a></h1> <h2 id="drafts">Drafts<a class="headerlink" href="#drafts" title="Permanent link">¶</a></h2> Used for interacting with unpublished or edited draft records. <div class="admonition info"> Authentication required All requests to the draft-related REST API endpoints require authentication. </div> <h3 id="create-a-draft-record">Create a draft record<a class="headerlink" href="#create-a-draft-record" title="Permanent link">¶</a></h3> <code>POST /api/records</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>access</code></td> <td>object</td> <td>body</td> <td><a href="../metadata/#access">Access options</a> for the record.</td> </tr> <tr> <td><code>files</code></td> <td>object</td> <td>body</td> <td>Files options (see below) for the record.</td> </tr> <tr> <td><code>metadata</code></td> <td>object</td> <td>body</td> <td><a href="../metadata/#metadata">Metadata</a> of the record.</td> </tr> <tr> <td><code>custom_fields</code></td> <td>object</td> <td>body</td> <td><a href="../../customize/metadata/custom_fields/records/#declaring-custom-fields">Custom fields</a> metadata for the record. (v10 and newer)</td> </tr> </tbody> </table> <h4 id="files-options">Files Options<a class="headerlink" href="#files-options" title="Permanent link">¶</a></h4> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>enabled</code></td> <td>boolean</td> <td>body</td> <td>Required. Should (and can) files be attached to this record or not.</td> </tr> <tr> <td><code>default_preview</code>  </td> <td>string</td> <td>body</td> <td>Filename of file to be previewed by default.</td> </tr> <tr> <td><code>order</code></td> <td>array</td> <td>body</td> <td>Array of filename strings in display order.</td> </tr> </tbody> </table> A file must be uploaded to the draft before it can be used as the default preview. See "<a href="#start-draft-file-uploads">Start a draft file upload</a>" below. Request <div class="highlight"><pre><code>POST /api/records HTTP/1.1 Content-Type: application/json { "access": { "record": "public", "files": "public" }, "files": { "enabled": true }, "metadata": { "creators": [ { "person_or_org": { "family_name": "Brown", "given_name": "Troy", "type": "personal" } }, { "person_or_org": { "family_name": "Collins", "given_name": "Thomas", "identifiers": [ {"scheme": "orcid", "identifier": "0000-0002-1825-0097"} ], "name": "Collins, Thomas", "type": "personal" }, "affiliations": [ { "id": "01ggx4157", "name": "Entity One" } ] } ], "publication_date": "2020-06-01", "resource_type": { "id": "image-photo" }, "title": "A Romans story", } } </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 201 CREATED Content-Type: application/json { "access": { "record": "public", "files": "public", "embargo": { "reason": null, "active": false } }, "created": "2020-11-27 10:52:23.945755", "expires_at": "2020-11-27 10:52:23.945868", "files": { "enabled": true }, "id": "{id}", "is_published": false, "links": { "latest": "{scheme+hostname}/api/records/{id}/versions/latest", "versions": "{scheme+hostname}/api/records/{id}/versions", "self_html": "{scheme+hostname}/uploads/{id}", "publish": "{scheme+hostname}/api/records/{id}/draft/actions/publish", "latest_html": "{scheme+hostname}/records/{id}/latest", "self": "{scheme+hostname}/api/records/{id}/draft", "files": "{scheme+hostname}/api/records/{id}/draft/files", "access_links": "{scheme+hostname}/api/records/{id}/access/links" }, "metadata": { "resource_type": { "id": "image-photo", "title": { "en": "Photo" } }, "title": "A Romans story", "publication_date": "2020-06-01", "creators": [ { "person_or_org": { "family_name": "Brown", "given_name": "Troy", "type": "personal" } }, { "person_or_org": { "family_name": "Collins", "given_name": "Thomas", "identifiers": [ {"scheme": "orcid", "identifier": "0000-0002-1825-0097"} ], "name": "Collins, Thomas", "type": "personal" }, "affiliations": [ { "id": "01ggx4157", "name": "European Organization for Nuclear Research" } ] } ], }, "parent": { "id": "{parent-id}", "access": { "owned_by": { "user": {user-id} }, "links": [] } }, "pids": {}, "revision_id": 3, "updated": "2020-11-27 10:52:23.969244", "versions": { "index": 1, "is_latest": false, "is_latest_draft": true } } </code></pre></div> Note how if a name and id are given for an affiliation identifiers. The instance's name it has for the given id is used e.g. "Entity One" is replaced by "European Organization for Nuclear Research" above. <h3 id="get-a-draft-record">Get a draft record<a class="headerlink" href="#get-a-draft-record" title="Permanent link">¶</a></h3> <code>GET /api/records/{id}/draft</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>4d0ns-ntd89</code></td> </tr> <tr> <td><code>accept</code></td> <td>string</td> <td>header</td> <td>- <code>application/json</code> (default) - <code>application/vnd.inveniordm.v1+json</code></td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>GET /api/records/{id}/draft HTTP/1.1 Accept: application/json </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Type: application/json { "access": { "record": "public", "files": "public", "embargo": { "reason": null, "active": false } }, "created": "2020-11-27 10:52:23.945755", "expires_at": "2020-11-27 10:52:23.945868", "files": { "enabled": true }, "id": "{id}", "is_published": false, "links": { "latest": "{scheme+hostname}/api/records/{id}/versions/latest", "versions": "{scheme+hostname}/api/records/{id}/versions", "self_html": "{scheme+hostname}/uploads/{id}", "publish": "{scheme+hostname}/api/records/{id}/draft/actions/publish", "latest_html": "{scheme+hostname}/records/{id}/latest", "self": "{scheme+hostname}/api/records/{id}/draft", "files": "{scheme+hostname}/api/records/{id}/draft/files", "access_links": "{scheme+hostname}/api/records/{id}/access/links" }, "metadata": { "resource_type": { "id": "image-photo", "title": { "en": "Photo" } }, "title": "A Romans story", "publication_date": "2020-06-01", "creators": [ "person_or_org": { "family_name": "Brown", "given_name": "Troy", "type": "personal" }, { "person_or_org": { "family_name": "Collins", "given_name": "Thomas", "identifiers": [ {"scheme": "orcid", "identifier": "0000-0002-1825-0097"} ], "name": "Collins, Thomas", "type": "personal" }, "affiliations": [ { "id": "01ggx4157", "name": "European Organization for Nuclear Research" } ] } ], }, "parent": { "id": "{parent-id}", "access": { "owned_by": { "user": {user-id} }, "links": [] } }, "pids": {}, "revision_id": 3, "updated": "2020-11-27 10:52:23.969244", "versions": { "index": 1, "is_latest": false, "is_latest_draft": true } } </code></pre></div> <h3 id="update-a-draft-record">Update a draft record<a class="headerlink" href="#update-a-draft-record" title="Permanent link">¶</a></h3> <code>PUT /api/records/{id}/draft</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>4d0ns-ntd89</code></td> </tr> <tr> <td><code>access</code></td> <td>object</td> <td>body</td> <td><a href="../metadata/#access">Access options</a> for the record.</td> </tr> <tr> <td><code>files</code></td> <td>object</td> <td>body</td> <td><a href="#files-options">Files options</a> for the record.</td> </tr> <tr> <td><code>metadata</code></td> <td>object</td> <td>body</td> <td><a href="../metadata/#metadata">Metadata</a> of the record.</td> </tr> <tr> <td><code>custom_fields</code></td> <td>object</td> <td>body</td> <td><a href="../../customize/metadata/custom_fields/records/#declaring-custom-fields">Custom fields</a> metadata for the record. (v10 and newer)</td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>PUT /api/records/{id}/draft HTTP/1.1 Content-Type: application/json { "access": { "record": "restricted", "files": "restricted" }, "files": { "enabled": false }, "metadata": { "creators": [ { "person_or_org": { "family_name": "Brown", "given_name": "Troy", "type": "personal" } }, { "person_or_org": { "family_name": "Collins", "given_name": "Thomas", "identifiers": [ {"scheme": "orcid", "identifier": "0000-0002-1825-0097"} ], "name": "Collins, Thomas", "type": "personal" }, "affiliations": [ { "id": "01ggx4157", "name": "Entity One" } ] } ], "publication_date": "2020-06-01", "resource_type": { "id": "image-photo" }, "title": "An Updated Romans story" } } </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Type: application/json { "access": { "record": "restricted", "files": "restricted", "embargo": { "reason": null, "active": false } }, "created": "2020-11-27 10:52:23.945755", "expires_at": "2020-11-27 10:52:23.945868", "files": { "enabled": false }, "id": "{id}", "is_published": false, "links": { "latest": "{scheme+hostname}/api/records/{id}/versions/latest", "versions": "{scheme+hostname}/api/records/{id}/versions", "self_html": "{scheme+hostname}/uploads/{id}", "publish": "{scheme+hostname}/api/records/{id}/draft/actions/publish", "latest_html": "{scheme+hostname}/records/{id}/latest", "self": "{scheme+hostname}/api/records/{id}/draft", "files": "{scheme+hostname}/api/records/{id}/draft/files", "access_links": "{scheme+hostname}/api/records/{id}/access/links" }, "metadata": { "resource_type": { "id": "image-photo", "title": { "en": "Photo" } }, "title": "An Updated Romans story", "publication_date": "2020-06-01", "creators": [ "person_or_org": { "family_name": "Brown", "given_name": "Troy", "type": "personal" }, { "person_or_org": { "family_name": "Collins", "given_name": "Thomas", "identifiers": [ {"scheme": "orcid", "identifier": "0000-0002-1825-0097"} ], "name": "Collins, Thomas", "type": "personal" }, "affiliations": [ { "id": "01ggx4157", "name": "European Organization for Nuclear Research" } ] } ], }, "parent": { "id": "{parent-id}", "access": { "owned_by": { "user": {user-id} }, "links": [] } }, "pids": {}, "revision_id": 3, "updated": "2020-11-27 10:52:23.969244", "versions": { "index": 1, "is_latest": false, "is_latest_draft": true } } </code></pre></div> <h3 id="publish-a-draft-record">Publish a draft record<a class="headerlink" href="#publish-a-draft-record" title="Permanent link">¶</a></h3> <code>POST /api/records/{id}/draft/actions/publish</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>4d0ns-ntd89</code></td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>POST /api/records/{id}/draft/actions/publish HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 202 ACCEPTED Content-Type: application/json { "access": { "record": "restricted", "files": "restricted", "embargo": { "reason": null, "active": false } }, "created": "2020-11-27 10:52:23.945755", "expires_at": "2020-11-27 10:52:23.945868", "files": { "enabled": false }, "id": "{id}", "is_published": true, "links": { "latest": "{scheme+hostname}/api/records/{id}/versions/latest", "versions": "{scheme+hostname}/api/records/{id}/versions", "self_html": "{scheme+hostname}/records/{id}", "latest_html": "{scheme+hostname}/records/{id}/latest", "self": "{scheme+hostname}/api/records/{id}", "files": "{scheme+hostname}/api/records/{id}/files", "access_links": "{scheme+hostname}/api/records/{id}/access/links" }, "metadata": { "resource_type": { "id": "image-photo", "title": { "en": "Photo" } }, "title": "An Updated Romans story", "publication_date": "2020-06-01", "creators": [ "person_or_org": { "family_name": "Brown", "given_name": "Troy", "type": "personal" }, { "person_or_org": { "family_name": "Collins", "given_name": "Thomas", "identifiers": [ {"scheme": "orcid", "identifier": "0000-0002-1825-0097"} ], "name": "Collins, Thomas", "type": "personal" }, "affiliations": [ { "id": "01ggx4157", "name": "European Organization for Nuclear Research" } ] } ], }, "parent": { "id": "{parent-id}", "access": { "owned_by": { "user": {user-id} }, "links": [] } }, "pids": {}, "revision_id": 3, "updated": "2020-11-27 10:52:23.969244", "versions": { "index": 1, "is_latest": true, "is_latest_draft": true } } </code></pre></div> <h3 id="edit-a-published-record-create-a-draft-record-from-a-published-record">Edit a published record (Create a draft record from a published record)<a class="headerlink" href="#edit-a-published-record-create-a-draft-record-from-a-published-record" title="Permanent link">¶</a></h3> <code>POST /api/records/{id}/draft</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>4d0ns-ntd89</code></td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>POST /api/records/{id}/draft HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 201 CREATED Content-Type: application/json { "access": { "record": "restricted", "files": "restricted", "embargo": { "reason": null, "active": false } }, "created": "2020-11-27 10:52:23.945755", "expires_at": "2020-11-27 10:52:23.945868", "files": { "enabled": false }, "id": "{id}", "is_published": false, "links": { "latest": "{scheme+hostname}/api/records/{id}/versions/latest", "versions": "{scheme+hostname}/api/records/{id}/versions", "self_html": "{scheme+hostname}/uploads/{id}", "publish": "{scheme+hostname}/api/records/{id}/draft/actions/publish", "latest_html": "{scheme+hostname}/records/{id}/latest", "self": "{scheme+hostname}/api/records/{id}/draft", "files": "{scheme+hostname}/api/records/{id}/draft/files", "access_links": "{scheme+hostname}/api/records/{id}/access/links" }, "metadata": { "resource_type": { "id": "image-photo", "title": { "en": "Photo" } }, "title": "An Updated Romans story", "publication_date": "2020-06-01", "creators": [ "person_or_org": { "family_name": "Brown", "given_name": "Troy", "type": "personal" }, { "person_or_org": { "family_name": "Collins", "given_name": "Thomas", "identifiers": [ {"scheme": "orcid", "identifier": "0000-0002-1825-0097"} ], "name": "Collins, Thomas", "type": "personal" }, "affiliations": [ { "id": "01ggx4157", "name": "European Organization for Nuclear Research" } ] } ], }, "parent": { "id": "{parent-id}", "access": { "owned_by": { "user": {user-id} }, "links": [] } }, "pids": {}, "revision_id": 3, "updated": "2020-11-27 10:52:23.969244", "versions": { "index": 1, "is_latest": true, "is_latest_draft": true } } </code></pre></div> <h3 id="deletediscard-a-draft-record">Delete/discard a draft record<a class="headerlink" href="#deletediscard-a-draft-record" title="Permanent link">¶</a></h3> <code>DELETE /api/records/{id}/draft</code> Deleting a draft for an unpublished record will remove the draft and associated files from the system. Deleting a draft for a published record will remove the draft but not the published record. Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>4d0ns-ntd89</code></td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>DELETE /api/records/{id}/draft HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 204 No Content </code></pre></div> <h2 id="draft-files">Draft files<a class="headerlink" href="#draft-files" title="Permanent link">¶</a></h2> Used to manage a draft's files. <div class="admonition info"> Authentication required All requests to the draft-related REST API endpoints require authentication. </div> <h3 id="list-a-drafts-files">List a draft's files<a class="headerlink" href="#list-a-drafts-files" title="Permanent link">¶</a></h3> <code>GET /api/records/{id}/draft/files</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>4d0ns-ntd89</code></td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>GET /api/records/{id}/draft/files HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Type: application/json { "default_preview": null, "enabled": true, "entries": [], "links": { "self": "/api/records/{id}/draft/files" }, "order": [] } </code></pre></div> <h3 id="start-draft-file-uploads">Start draft file upload(s)<a class="headerlink" href="#start-draft-file-uploads" title="Permanent link">¶</a></h3> <code>POST /api/records/{id}/draft/files</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>4d0ns-ntd89</code></td> </tr> <tr> <td><code><top-level></code></td> <td>array</td> <td>body</td> <td>Array of objects describing the file uploads to be initialized.</td> </tr> <tr> <td><code>[].key</code></td> <td>string</td> <td>body</td> <td>Name of the file to be uploaded.</td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>POST /api/records/{id}/draft/files HTTP/1.1 Content-Type: application/json [ {"key": "figure.png"}, {"key": "article.pdf"}, {"key": "data.zip"} ] </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 201 CREATED Content-Type: application/json { "enabled": true, "default_preview": null, "order": [], "entries": [ { "key": "figure.png", "updated": "2020-11-27 11:17:11.002624", "created": "2020-11-27 11:17:10.998919", "metadata": null, "status": "pending", "links": { "content": "/api/records/{id}/draft/files/figure.png/content", "self": "/api/records/{id}/draft/files/figure.png", "commit": "/api/records/{id}/draft/files/figure.png/commit" }, }, { "key": "article.pdf", "updated": "2020-11-27 11:17:11.002624", "created": "2020-11-27 11:17:10.998919", "metadata": null, "status": "pending", "links": { "content": "/api/records/{id}/draft/files/article.pdf/content", "self": "/api/records/{id}/draft/files/article.pdf", "commit": "/api/records/{id}/draft/files/article.pdf/commit" }, }, { "key": "data.zip", "updated": "2020-11-27 11:17:11.002624", "created": "2020-11-27 11:17:10.998919", "metadata": null, "status": "pending", "links": { "content": "/api/records/{id}/draft/files/data.zip/content", "self": "/api/records/{id}/draft/files/data.zip", "commit": "/api/records/{id}/draft/files/data.zip/commit" }, } ], "links": { "self": "/api/records/{id}/draft/files" }, } </code></pre></div> <h3 id="upload-a-draft-files-content">Upload a draft file's content<a class="headerlink" href="#upload-a-draft-files-content" title="Permanent link">¶</a></h3> <code>PUT /api/records/{id}/draft/files/{filename}/content</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>4d0ns-ntd89</code></td> </tr> <tr> <td><code>filename</code></td> <td>string</td> <td>path</td> <td>Name of the file.</td> </tr> <tr> <td><code>content-type</code></td> <td>string</td> <td>header</td> <td>Should always be <code>application/octet-stream</code>.</td> </tr> <tr> <td><code>content-length</code></td> <td>integer</td> <td>header</td> <td>Size of the content in bytes (optional).</td> </tr> <tr> <td><code><content></code></td> <td>bytes</td> <td>body</td> <td>The raw bytes of the file content to be uploaded.</td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>PUT /api/records/{id}/draft/files/{filename}/content HTTP/1.1 Content-Type: application/octet-stream <...file binary data...> </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Type: application/json { "key": "{filename}", "updated": "2020-11-27 11:17:11.002624", "created": "2020-11-27 11:17:10.998919", "metadata": null, "status": "pending", "links": { "content": "/api/records/{id}/draft/files/{filename}/content", "self": "/api/records/{id}/draft/files/{filename}", "commit": "/api/records/{id}/draft/files/{filename}/commit" }, } </code></pre></div> Code sample <div class="highlight"><pre><code>curl \ --request PUT \ --header "Content-Type: application/octet-stream" \ https://127.0.0.1:5000//api/records/{id}/draft/files/{filename}/content \ --upload-file /path/to/file </code></pre></div> <h3 id="complete-a-draft-file-upload">Complete a draft file upload<a class="headerlink" href="#complete-a-draft-file-upload" title="Permanent link">¶</a></h3> <code>POST /api/records/{id}/draft/files/{filename}/commit</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>4d0ns-ntd89</code></td> </tr> <tr> <td><code>filename</code></td> <td>string</td> <td>path</td> <td>Name of the file.</td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>POST /api/records/{id}/draft/files/{filename}/commit HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Type: application/json { "key": "{filename}", "updated": "2020-11-27 11:26:04.607831", "created": "2020-11-27 11:17:10.998919", "checksum": "md5:6ef4267f0e710357c895627e931f16cd", "mimetype": "image/png", "size": 89364.0, "status": "completed", "metadata": null, "file_id": "2151fa94-6dc3-4965-8df9-ec73ceb9175c", "version_id": "57ad8c66-b934-49c9-a46f-38bf5aa0374f", "bucket_id": "90b5b318-114a-4b87-bc9d-0d018b9363d3", "storage_class": "S", "links": { "content": "/api/records/{id}/draft/files/{filename}/content", "self": "/api/records/{id}/draft/files/{filename}", "commit": "/api/records/{id}/draft/files/{filename}/commit" }, } </code></pre></div> <h3 id="get-a-draft-files-metadata">Get a draft file's metadata<a class="headerlink" href="#get-a-draft-files-metadata" title="Permanent link">¶</a></h3> <code>GET /api/records/{id}/draft/files/{filename}</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>4d0ns-ntd89</code></td> </tr> <tr> <td><code>filename</code></td> <td>string</td> <td>path</td> <td>Name of the file.</td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>GET /api/records/{id}/draft/files/{filename} HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Type: application/json { "key": "{filename}", "updated": "2020-11-27 11:26:04.607831", "created": "2020-11-27 11:17:10.998919", "checksum": "md5:6ef4267f0e710357c895627e931f16cd", "mimetype": "image/png", "size": 89364.0, "status": "completed", "metadata": { "width": 960, "height": 640 }, "file_id": "2151fa94-6dc3-4965-8df9-ec73ceb9175c", "version_id": "57ad8c66-b934-49c9-a46f-38bf5aa0374f", "bucket_id": "90b5b318-114a-4b87-bc9d-0d018b9363d3", "storage_class": "S", "links": { "content": "/api/records/{id}/draft/files/{filename}/content", "self": "/api/records/{id}/draft/files/{filename}", "commit": "/api/records/{id}/draft/files/{filename}/commit" }, } </code></pre></div> <h3 id="download-a-draft-file">Download a draft file<a class="headerlink" href="#download-a-draft-file" title="Permanent link">¶</a></h3> <code>GET /api/records/{id}/draft/files/{filename}/content</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>cbc2k-q9x58</code></td> </tr> <tr> <td><code>filename</code></td> <td>string</td> <td>path</td> <td>Name of a file</td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>GET /api/records/{id}/draft/files/{filename}/content HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Disposition: inline Content-Length: 76122 Content-MD5: 71449104d017a6056ac1a5fb58754975 Content-Type: image/pdf Date: Thu, 26 Nov 2020 18:35:33 GMT ETag: "md5:71449104d017a6056ac1a5fb58754975" Last-Modified: Thu, 26 Nov 2020 14:30:06 GMT <...file binary data...> </code></pre></div> <h3 id="delete-a-draft-file">Delete a draft file<a class="headerlink" href="#delete-a-draft-file" title="Permanent link">¶</a></h3> <code>DELETE /api/records/{id}/draft/files/{filename}</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>4d0ns-ntd89</code></td> </tr> <tr> <td><code>filename</code></td> <td>string</td> <td>path</td> <td>Name of the file.</td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>DELETE /api/records/{id}/draft/files/{filename} HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 204 No Content </code></pre></div> <h2 id="records">Records<a class="headerlink" href="#records" title="Permanent link">¶</a></h2> Used for interacting with published records. <h3 id="get-a-record">Get a record<a class="headerlink" href="#get-a-record" title="Permanent link">¶</a></h3> <code>GET /api/records/{id}</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>cbc2k-q9x58</code></td> </tr> <tr> <td><code>accept</code></td> <td>string</td> <td>header</td> <td>- <code>application/json</code> (default) - <code>application/vnd.inveniordm.v1+json</code></td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>GET /api/records/{id} HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Type: application/json { "access": { "record": "restricted", "files": "restricted", "embargo": { "reason": null, "active": false } }, "created": "2020-11-27 10:52:23.945755", "expires_at": "2020-11-27 10:52:23.945868", "files": { "enabled": true }, "id": "{id}", "is_published": true, "links": { "latest": "{scheme+hostname}/api/records/{id}/versions/latest", "versions": "{scheme+hostname}/api/records/{id}/versions", "self_html": "{scheme+hostname}/records/{id}", "latest_html": "{scheme+hostname}/records/{id}/latest", "self": "{scheme+hostname}/api/records/{id}", "self_iiif_manifest": "{scheme+hostname}/api/records/{id}/manifest", "self_iiif_sequence": "{scheme+hostname}/api/records/{id}/sequence/default", "files": "{scheme+hostname}/api/records/{id}/files", "access_links": "{scheme+hostname}/api/records/{id}/access/links", "communities": "{scheme+hostname}/api/records/{id}/communities", "requests": "{scheme+hostname}/api/records/{id}/requests", "communities-suggestions": "{scheme+hostname}/api/records/{id}/communities-suggestions" }, "metadata": { "resource_type": { "id": "image-photo", "title": { "en": "Photo" } }, "title": "An Updated Romans story", "publication_date": "2020-06-01", "creators": [ { "person_or_org": { "given_name": "Troy", "type": "personal", "name": "Brown, Troy", "family_name": "Brown" } }, { "person_or_org": { "family_name": "Collins", "given_name": "Thomas", "identifiers": [ {"scheme": "orcid", "identifier": "0000-0002-1825-0097"} ], "name": "Collins, Thomas", "type": "personal" }, "affiliations": [ { "id": "01ggx4157", "name": "European Organization for Nuclear Research" } ] } ], }, "parent": { "id": "{parent-id}", "access": { "owned_by": { "user": {user-id} }, "links": [] } }, "pids": {}, "revision_id": 3, "updated": "2020-11-27 10:52:23.969244", "versions": { "index": 1, "is_latest": true, "is_latest_draft": true } } </code></pre></div> <h3 id="search-records">Search records<a class="headerlink" href="#search-records" title="Permanent link">¶</a></h3> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>q</code></td> <td>string</td> <td>query</td> <td>Search query used to filter results based on <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-query-string-query.html#query-string-syntax">ElasticSearch's query string syntax</a>.</td> </tr> <tr> <td><code>sort</code></td> <td>string</td> <td>query</td> <td>Sort search results. Customizable. Built-in options are <code>"bestmatch"</code>, <code>"newest"</code>, <code>"oldest"</code>, <code>"updated-desc"</code>, <code>"updated-asc"</code>, <code>"version"</code>, <code>"mostviewed"</code>, <code>"mostdownloaded"</code> (default: <code>"bestmatch"</code> or <code>"newest"</code>).</td> </tr> <tr> <td><code>size</code></td> <td>integer</td> <td>query</td> <td>Specify number of items in the results page (default: 10).</td> </tr> <tr> <td><code>page</code></td> <td>integer</td> <td>query</td> <td>Specify the page of results.</td> </tr> <tr> <td><code>allversions</code>  </td> <td>boolean</td> <td>query</td> <td>Specify if all versions should be included (default: <code>False</code>, displays just latest version).</td> </tr> <tr> <td><code>accept</code></td> <td>string</td> <td>header</td> <td>- <code>application/json</code> (default) - <code>application/vnd.inveniordm.v1+json</code></td> </tr> </tbody> </table> Sort options for records can be configured using the <code>RDM_SORT_OPTIONS</code> config variable as described in the <a href="../../customize/search/">search customization</a> section. Note that <code>"bestmatch"</code> is only available as a sort option on requests that provide a query string as a <code>q</code> parameter. Otherwise <code>"bestmatch"</code> is ignored and the default <code>"newest"</code> sort is used. Queries sorted by <code>"mostviewed"</code> and <code>"mostdownloaded"</code> are in descending order. Request <div class="highlight"><pre><code>GET /api/records HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Type: application/json { "aggregations": {...}, "hits": {...}, "links": {...}, "sortBy": ..., } </code></pre></div> Each hit looks like a record above. <h2 id="record-files">Record files<a class="headerlink" href="#record-files" title="Permanent link">¶</a></h2> Used for interacting with files of published records. <h3 id="list-a-records-files">List a record's files<a class="headerlink" href="#list-a-records-files" title="Permanent link">¶</a></h3> <code>GET /api/records/{id}/files</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>cbc2k-q9x58</code></td> </tr> <tr> <td><code>accept</code></td> <td>string</td> <td>header</td> <td>- <code>application/json</code> (default)</td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>GET /api/records/{id}/files HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Type: application/json { "enabled": true, "default_preview": "article.pdf", "order": [], "entries": [ { "key": "article.pdf", "created": "2020-11-26 14:30:53.911912", "updated": "2020-11-26 14:30:53.920544", "checksum": "md5:71449104d017a6056ac1a5fb58754975", "mimetype": "application/pdf", "size": 76122, "status": "completed", "metadata": {...}, "file_id": "...", "version_id": "...", "bucket_id": "...", "storage_class": "S", "links": { "content": "/api/records/{id}/files/article.pdf/content", "self": "/api/records/{id}/files/article.pdf" } } ] "links": {...}, } </code></pre></div> <h3 id="get-a-record-files-metadata">Get a record file's metadata<a class="headerlink" href="#get-a-record-files-metadata" title="Permanent link">¶</a></h3> <code>GET /api/records/{id}/files/{filename}</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>cbc2k-q9x58</code></td> </tr> <tr> <td><code>filename</code></td> <td>string</td> <td>path</td> <td>Name of a file</td> </tr> <tr> <td><code>accept</code></td> <td>string</td> <td>header</td> <td>- <code>application/json</code> (default)</td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>GET /api/records/{id}/files/{filename} HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Type: application/json { "key": "{filename}", "created": "2020-11-26 14:30:53.911912", "updated": "2020-11-26 14:30:53.920544", "checksum": "md5:71449104d017a6056ac1a5fb58754975", "mimetype": "application/pdf", "size": 76122, "status": "completed", "metadata": {...}, "file_id": "...", "version_id": "...", "bucket_id": "...", "storage_class": "S", "links": { "content": "/api/records/{id}/files/{filename}/content", "self": "/api/records/{id}/files/{filename}" } } </code></pre></div> <h3 id="download-a-record-file">Download a record file<a class="headerlink" href="#download-a-record-file" title="Permanent link">¶</a></h3> <code>GET /api/records/{id}/files/{filename}/content</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>cbc2k-q9x58</code></td> </tr> <tr> <td><code>filename</code></td> <td>string</td> <td>path</td> <td>Name of a file</td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>GET /api/records/{id}/files/{filename}/content HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Disposition: inline Content-Length: 76122 Content-MD5: 71449104d017a6056ac1a5fb58754975 Content-Type: image/pdf Date: Thu, 26 Nov 2020 18:35:33 GMT ETag: "md5:71449104d017a6056ac1a5fb58754975" Last-Modified: Thu, 26 Nov 2020 14:30:06 GMT <...file binary data...> </code></pre></div> <h2 id="versions">Versions<a class="headerlink" href="#versions" title="Permanent link">¶</a></h2> Used for interacting with record versions. <h3 id="create-a-new-version">Create a new version<a class="headerlink" href="#create-a-new-version" title="Permanent link">¶</a></h3> <code>POST /api/records/{id}/versions</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>4d0ns-ntd89</code></td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>POST /api/records/{id}/versions HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 201 OK Content-Type: application/json { "access": { "record": "restricted", "files": "restricted", "embargo": { "reason": null, "active": false } }, "created": "2020-11-27 10:52:23.945755", "expires_at": "2020-11-27 10:52:23.945868", "files": { "enabled": true }, "id": "{new-id}", "is_published": false, "links": { "latest": "{scheme+hostname}/api/records/{id}/versions/latest", "versions": "{scheme+hostname}/api/records/{id}/versions", "self_html": "{scheme+hostname}/uploads/{id}", "publish": "{scheme+hostname}/api/records/{id}/draft/actions/publish", "latest_html": "{scheme+hostname}/records/{id}/latest", "self": "{scheme+hostname}/api/records/{id}/draft", "files": "{scheme+hostname}/api/records/{id}/draft/files", "access_links": "{scheme+hostname}/api/records/{id}/access/links" "communities": "{scheme+hostname}/api/records/{id}/communities", "requests": "{scheme+hostname}/api/records/{id}/requests", "communities-suggestions": "{scheme+hostname}/api/records/{id}/communities-suggestions" }, "metadata": { "resource_type": { "id": "image-photo", "title": { "en": "Photo" } }, "title": "An Updated Romans story", "creators": [ "person_or_org": { "family_name": "Brown", "given_name": "Troy", "name": "Brown, Troy", "type": "personal" }, { "person_or_org": { "family_name": "Collins", "given_name": "Thomas", "identifiers": [ {"scheme": "orcid", "identifier": "0000-0002-1825-0097"} ], "name": "Collins, Thomas", "type": "personal" }, "affiliations": [ { "id": "01ggx4157", "name": "European Organization for Nuclear Research" } ] } ], }, "parent": { "id": "{parent-id}", "access": { "owned_by": { "user": {user-id} }, "links": [] } }, "pids": {}, "revision_id": 3, "updated": "2020-11-27 10:52:23.969244", "versions": { "index": 2, "is_latest": false, "is_latest_draft": true } } </code></pre></div> Notice that a new draft is returned with <code>publication_date</code> and <code>version</code> removed (as those are typically replaced in a new version). The <code>versions.index</code> is also incremented. The <code>{parent-id}</code> connects the different versions together. The new draft version has no files. However, it is possible to link files from the previous version (avoiding the need to re-upload, which would also cause duplication in the file store). See below. Use <a href="#publish-a-draft-record">Publish a draft record</a> to publish it. <h3 id="link-files-from-previous-version">Link files from previous version<a class="headerlink" href="#link-files-from-previous-version" title="Permanent link">¶</a></h3> <code>POST /api/records/{id}/draft/actions/files-import</code> Links all files from the previous version to the new record. Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the new draft version, e.g., <code>1bc9x-3pq5x</code></td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>POST /api/records/{id}/draft/actions/files-import HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 201 CREATED Content-Type: application/json { "enabled": true, "default_preview": "article.pdf", "order": [], "entries": [ { "key": "article.pdf", "created": "2020-11-26 14:30:53.911912", "updated": "2020-11-26 14:30:53.920544", "checksum": "md5:71449104d017a6056ac1a5fb58754975", "mimetype": "application/pdf", "size": 76122, "status": "completed", "metadata": {...}, "file_id": "...", "version_id": "...", "bucket_id": "...", "storage_class": "S", "links": {...} } ] "links": {...}, } </code></pre></div> Note this call links all files from the previous version. Any files to be removed or updated can be <a href="#delete-a-draft-file">deleted</a> from the draft version and remain attached to the previous version. <h3 id="get-all-versions">Get all versions<a class="headerlink" href="#get-all-versions" title="Permanent link">¶</a></h3> <code>GET /api/records/{id}/versions</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>4d0ns-ntd89</code></td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>GET /api/records/{id}/versions HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Type: application/json { "hits": {...}, "sortBy": "version", "links": {...} } </code></pre></div> <h3 id="get-latest-version">Get latest version<a class="headerlink" href="#get-latest-version" title="Permanent link">¶</a></h3> Given a record, it returns its latest version. <code>GET /api/records/{id}/versions/latest</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of a record, e.g. <code>cbc2k-q9x58</code></td> </tr> <tr> <td><code>accept</code></td> <td>string</td> <td>header</td> <td>- <code>application/json</code> (default) - <code>application/vnd.inveniordm.v1+json</code></td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>GET /api/records/{id}/versions/latest HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Type: application/json { "access": { "record": "restricted", "files": "restricted", "embargo": { "reason": null, "active": false }, "status": "restricted" }, "created": "2020-11-27 10:52:23.945755", "expires_at": "2020-11-27 10:52:23.945868", "files": { "enabled": true, "order": [] }, "id": "{latest-version-id}", "is_published": true, "links": { "latest": "{scheme+hostname}/api/records/{id}/versions/latest", "versions": "{scheme+hostname}/api/records/{id}/versions", "self_html": "{scheme+hostname}/records/{id}", "latest_html": "{scheme+hostname}/records/{id}/latest", "self": "{scheme+hostname}/api/records/{id}", "files": "{scheme+hostname}/api/records/{id}/files", "access_links": "{scheme+hostname}/api/records/{id}/access/links", "communities": "{scheme+hostname}/api/records/{id}/communities", "requests": "{scheme+hostname}/api/records/{id}/requests", "communities-suggestions": "{scheme+hostname}/api/records/{id}/communities-suggestions" }, "metadata": { "resource_type": { "id": "image-photo", "title": { "en": "Photo" } }, "title": "An Updated Romans story", "publication_date": "2020-06-01", "creators": [ "person_or_org": { "family_name": "Brown", "given_name": "Troy", "type": "personal" }, { "person_or_org": { "family_name": "Collins", "given_name": "Thomas", "identifiers": [ {"scheme": "orcid", "identifier": "0000-0002-1825-0097"} ], "name": "Collins, Thomas", "type": "personal" }, "affiliations": [ { "id": "01ggx4157", "name": "European Organization for Nuclear Research" } ] } ], }, "parent": { "id": "{parent-id}", "access": { "owned_by": { "user": {user-id} }, "links": [] } }, "pids": {}, "revision_id": 3, "updated": "2020-11-27 10:52:23.969244", "versions": { "index": 2, "is_latest": true, "is_latest_draft": true } } </code></pre></div> <h2 id="access-links">Access links<a class="headerlink" href="#access-links" title="Permanent link">¶</a></h2> Access links are URLs that can be shared with others to give them access and permissions to a record/draft. <h3 id="create-an-access-link">Create an access link<a class="headerlink" href="#create-an-access-link" title="Permanent link">¶</a></h3> <code>POST /api/records/{id}/access/links</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>cbc2k-q9x58</code></td> </tr> <tr> <td><code>accept</code></td> <td>string</td> <td>header</td> <td>- <code>application/json</code> (default) - <code>application/vnd.inveniordm.v1+json</code></td> </tr> <tr> <td><code>expires_at</code></td> <td>string</td> <td>body</td> <td><code>ISO 8601 Date</code>Format (YYYY-MM-DD) When the link expires.</td> </tr> <tr> <td><code>permission</code></td> <td>string</td> <td>body</td> <td>Required. Action that can be undertaken with the link (<code>view</code>, <code>preview</code> or <code>edit</code>).</td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>POST /api/records/{id}/access/links HTTP/1.1 Content-Type: application/json { "permission": "view", "expires_at": "2024-11-06" } </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 201 CREATED Content-Type: application/json { "id": "07fb00f3-928c-4ce9-8d2e-8e9c4dca3092", "created_at": "2024-06-12T13:07:09.951029+00:00", "expires_at": "2024-11-06", "permission": "view", "description": "", "token": "eyJhbGciOiJIUzUxMiIsImlhdCI6MTcxODE5NzYyOSwiZXhwIjoxNzMwODUxMTk5fQ.eyJpZCI6IjA3ZmIwMGYzLTkyOGMtNGNlOS04ZDJlLThlOWM0ZGNhMzA5MiIsImRhdGEiOnt9LCJyYW5kb20iOiI1NzVjNzEwY2QwNWI3YWFhMTM2MzY3ZmMzZWFkYzA0MSJ9.GPfPBvrbvEu-JMddFXjb5MZKNWRnzAK53oTVOSgfdZOcMIoRfszO39GEglko74dohZiUcJ11jWXj0fwfdq1WnQ" } </code></pre></div> <h3 id="get-an-access-link">Get an access link<a class="headerlink" href="#get-an-access-link" title="Permanent link">¶</a></h3> <code>GET /api/records/{id}/access/links/{link-id}</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>cbc2k-q9x58</code></td> </tr> <tr> <td><code>link-id</code></td> <td>string</td> <td>path</td> <td>Identifier of the link, e.g. <code>3d3320ea-0755-4d93-a76e-e2f2fc655d2a</code></td> </tr> <tr> <td><code>accept</code></td> <td>string</td> <td>header</td> <td>- <code>application/json</code> (default) - <code>application/vnd.inveniordm.v1+json</code></td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>GET /api/records/{id}/access/links/{link-id} HTTP/1.1 Content-Type: application/json </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Type: application/json { "id": "61c2d20f-4c88-440d-9978-dd16a69bf97e", "created_at": "2024-06-12T13:23:11.271139+00:00", "expires_at": "2024-11-06", "permission": "view", "description": "", "token": "eyJhbGciOiJIUzUxMiIsImlhdCI6MTcxODE5ODU5MSwiZXhwIjoxNzMwODUxMTk5fQ.eyJpZCI6IjYxYzJkMjBmLTRjODgtNDQwZC05OTc4LWRkMTZhNjliZjk3ZSIsImRhdGEiOnt9LCJyYW5kb20iOiI2MWYwZTg4YjgzY2E2ZDhkMjJiMTY0MGFjNmIzMmEwZiJ9.AFEmgQ8_gtEj7dvlZ2MHD9qneKy0UEC1HMByo8J5xVGMYG8PXwuRsyUgeq_k_ZeHybO5W4_Do_P4NVGXsrjHyg" } </code></pre></div> <h3 id="update-an-access-link">Update an access link<a class="headerlink" href="#update-an-access-link" title="Permanent link">¶</a></h3> <code>PATCH /api/records/{id}/access/links/{link-id}</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>cbc2k-q9x58</code></td> </tr> <tr> <td><code>link-id</code></td> <td>string</td> <td>path</td> <td>Identifier of the link, e.g. <code>3d3320ea-0755-4d93-a76e-e2f2fc655d2a</code></td> </tr> <tr> <td><code>accept</code></td> <td>string</td> <td>header</td> <td>- <code>application/json</code> (default) - <code>application/vnd.inveniordm.v1+json</code></td> </tr> <tr> <td><code>expires_at</code></td> <td>string</td> <td>body</td> <td><code>ISO 8601 Date</code>Format (YYYY-MM-DD) When the link expires.</td> </tr> <tr> <td><code>permission</code></td> <td>string</td> <td>body</td> <td>Required. Action that can be undertaken with the link.</td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>PATCH /api/records/{id}/access/links/{link-id} HTTP/1.1 Content-Type: application/json { "permission": "edit", "expires_at": "2024-11-06" } </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Type: application/json { "id": "df672812-6b23-411a-b40a-9bb22787f0a2", "created_at": "2024-06-12T12:48:43.724970+00:00", "expires_at": "2024-11-06", "permission": "edit", "description": "", "token": "eyJhbGciOiJIUzUxMiJ9.eyJpZCI6ImRmNjcyODEyLTZiMjMtNDExYS1iNDBhLTliYjIyNzg3ZjBhMiIsImRhdGEiOnt9LCJyYW5kb20iOiIwZWE3ZWQ5YTBiZTE3N2ZjMjE4YjNjYzY3M2RiOTI5OSJ9.kqJ_gTvgjEc_-1Jxv-XHqSCUmOpcQDdBzx-T5BP7ybvQItK91wGxmVT_gfHxyHHDQ_7e8_LH1A5TotAZCA8q_w" } </code></pre></div> <h3 id="delete-an-access-link">Delete an access link<a class="headerlink" href="#delete-an-access-link" title="Permanent link">¶</a></h3> <code>DELETE /api/records/{id}/access/links/{link-id}</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>cbc2k-q9x58</code></td> </tr> <tr> <td><code>link-id</code></td> <td>string</td> <td>path</td> <td>Identifier of the link, e.g. <code>3d3320ea-0755-4d93-a76e-e2f2fc655d2a</code></td> </tr> <tr> <td><code>accept</code></td> <td>string</td> <td>header</td> <td>- <code>application/json</code> (default) - <code>application/vnd.inveniordm.v1+json</code></td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>DELETE /api/records/{id}/access/links/{link-id} HTTP/1.1 Content-Type: application/json </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 204 No Content </code></pre></div> <h3 id="list-access-links">List access links<a class="headerlink" href="#list-access-links" title="Permanent link">¶</a></h3> <code>GET /api/records/{id}/access/links</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>path</td> <td>Identifier of the record, e.g. <code>cbc2k-q9x58</code></td> </tr> <tr> <td><code>accept</code></td> <td>string</td> <td>header</td> <td>- <code>application/json</code> (default) - <code>application/vnd.inveniordm.v1+json</code></td> </tr> </tbody> </table> Request <div class="highlight"><pre><code>GET /api/records/{id}/access/links HTTP/1.1 Content-Type: application/json </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Type: application/json { "hits": { "hits": [ { "id": "61c2d20f-4c88-440d-9978-dd16a69bf97e", "created_at": "2024-06-12T13:23:11.271139+00:00", "expires_at": "2024-11-06", "permission": "edit", "description": "", "token": "eyJhbGciOiJIUzUxMiIsImlhdCI6MTcxODE5ODU5MSwiZXhwIjoxNzMwODUxMTk5fQ.eyJpZCI6IjYxYzJkMjBmLTRjODgtNDQwZC05OTc4LWRkMTZhNjliZjk3ZSIsImRhdGEiOnt9LCJyYW5kb20iOiI2MWYwZTg4YjgzY2E2ZDhkMjJiMTY0MGFjNmIzMmEwZiJ9.AFEmgQ8_gtEj7dvlZ2MHD9qneKy0UEC1HMByo8J5xVGMYG8PXwuRsyUgeq_k_ZeHybO5W4_Do_P4NVGXsrjHyg" } ], "total": 1 } } </code></pre></div> <h2 id="user-records">User Records<a class="headerlink" href="#user-records" title="Permanent link">¶</a></h2> Used for interacting with the records and drafts you can edit. <h3 id="list-your-draft-and-published-records">List your draft and published records<a class="headerlink" href="#list-your-draft-and-published-records" title="Permanent link">¶</a></h3> <code>GET /api/user/records</code> Parameters <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Location</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>q</code></td> <td>string</td> <td>query</td> <td>Search query used to filter results based on <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-query-string-query.html#query-string-syntax">ElasticSearch's query string syntax</a>.</td> </tr> <tr> <td><code>sort</code></td> <td>string</td> <td>query</td> <td>Sort search results. Customizable. Built-in options are <code>"bestmatch"</code>, <code>"newest"</code>, <code>"oldest"</code>, <code>"updated-desc"</code>, <code>"updated-asc"</code>, <code>"version"</code>, <code>"mostviewed"</code>, <code>"mostdownloaded"</code> (default: <code>"bestmatch"</code> or <code>"newest"</code>).</td> </tr> <tr> <td><code>size</code></td> <td>integer</td> <td>query</td> <td>Specify number of items in the results page (default: 10).</td> </tr> <tr> <td><code>page</code></td> <td>integer</td> <td>query</td> <td>Specify the page of results.</td> </tr> <tr> <td><code>allversions</code>  </td> <td>boolean</td> <td>query</td> <td>Specify if all versions should be included.</td> </tr> <tr> <td><code>accept</code></td> <td>string</td> <td>header</td> <td>- <code>application/json</code> (default) - <code>application/vnd.inveniordm.v1+json</code></td> </tr> </tbody> </table> Sort options for records can be configured using the <code>RDM_SORT_OPTIONS</code> config variable as described in the <a href="../../customize/search/">search customization</a> section. Note that <code>"bestmatch"</code> is only available as a sort option on requests that provide a query string as a <code>q</code> parameter. Otherwise <code>"bestmatch"</code> is ignored and the default <code>"newest"</code> sort is used. Queries sorted by <code>"mostviewed"</code> and <code>"mostdownloaded"</code> are in descending order. Request <div class="highlight"><pre><code>GET /api/user/records HTTP/1.1 </code></pre></div> Response <div class="highlight"><pre><code>HTTP/1.1 200 OK Content-Type: application/json { "aggregations": {...}, "hits": {...}, "links": {...}, "sortBy": ..., } </code></pre></div> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class="md-footer"> <nav class="md-footer__inner md-grid" aria-label="Footer" > <a href="../rest_api_communities/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Communities"> <div class="md-footer__button md-icon"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </div> <div class="md-footer__title"> Previous <div class="md-ellipsis"> Communities </div> </div> </a> <a href="../rest_api_groups/" class="md-footer__link md-footer__link--next" aria-label="Next: Groups"> <div class="md-footer__title"> Next <div class="md-ellipsis"> Groups </div> </div> <div class="md-footer__button md-icon"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11z"/></svg> </div> </a> </nav> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class="md-copyright"> <div class="md-copyright__highlight"> Copyright © 2019-2024 CERN, Northwestern University and contributors. </div> Made with <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener"> Material for MkDocs </a> </div> <div class="md-social"> <a href="https://github.com/inveniosoftware" target="_blank" rel="noopener" title="github.com" class="md-social__link"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8M97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg> </a> </div> </div> </div> </footer> </div> <div class="md-dialog" data-md-component="dialog"> <div class="md-dialog__inner md-typeset"></div> </div> <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.footer", "content.code.copy"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src="../../assets/javascripts/bundle.525ec568.min.js"></script> </body> </html>

CINXE.COM

Drafts and Records - Turn-key research data management repository