Sign in
latestOpenAPI 3.1.02026-08-08264458.4 KB

5e35babfb8d2

datasets

Update (overwrite) dataset metadata for DOI

This will overwrite writeable metadata for an in-progress dataset. This is an insert or update action (upsert). Be sure to URL encode the DOI (see example below). You must be <a href="https://github.com/datadryad/dryad-app/blob/main/documentation/apis/api_accounts.md">logged in</a>. Use a JSON structure as shown below. For a more full list of properties that can be sent, check the Schema below and the <a href="https://github.com/datadryad/dryad-app/blob/main/documentation/apis/sample_dataset.json" target="_blank">sample dataset object</a>.

put/datasets/{doi}

Path parameters

doistring required

DOI like doi:10.1000/18238577 that should be URL encoded (example: <code>doi%3A10.1000%2F18238577</code>)

Request body

titlestring required
abstractstring required

An abstract introducing the dataset.

keywordsstring[]
fieldOfSciencestring

A term from the FOS (Fields of Science and Technology) controlled vocabulary. The main category of the dataset.

hsiStatementstring

A statement explaining the de-identification of any human subject data in the dataset.

methodsstring

The methods by which the data was produced. Not required for publication.

usageNotesstring

Usage notes for the dataset (Deprecated; It is preferred for this content to appear in the README file for the dataset). If the dataset has been retracted, the retraction statement will appear here.

identifierstring

The Dryad dataset DOI

userIdstring

The Dryad user ID, or ORCID iD, of the user who will submit the dataset. If this is unknown, the userId must be set to 0 to allow for an invitation link.

publicationISSNstring

An ISSN for the associated journal

publicationNamestring

The title of the associated journal

manuscriptNumberstring

The internal manuscript number assigned to an associated article before publication

skipEmailsboolean

Administrator value. Prevents emails being sent automatically.

triggerSubmitInvitationboolean

Administrator value. Sends an editing invitation email to the first author.

preserveCurationStatusboolean

Administrator value. Prevents automatic curation status changes.

holdForPeerReviewboolean

Administrator value. Sets whether the submission will be sent to curation or a peer review hold status.

loosenValidationboolean

For superusers only.

skipDataciteUpdateboolean

For superusers only.

invoiceIdstring

For superusers only.

Example request

{
  "funders": [
    {
      "identifier": "https://ror.org/00x6h5n95",
      "identifierType": "ror"
    }
  ]
}

Response

Show the dataset information that has been saved.

countinteger
totalinteger

Example response

{
  "_embedded": {
    "stash:datasets": [
      {
        "funders": [
          {
            "identifier": "https://ror.org/00x6h5n95",
            "identifierType": "ror"
          }
        ]
      }
    ]
  }
}