latestOpenAPI 3.1.02026-08-08264458.4 KB

5e35babfb8d2

files

Stage a file submission by URL

The URL you specify will be deposited into the storage repository from a publicly accessible URL on the internet when the in-progress dataset is submitted. The dataset must be an in-progress dataset. The URL will be validated and metadata about it obtained to populate metadata about the file when it is added. Send the url to be retrieved as part of a JSON document like {'url': 'http://example.org/testing/my/file.csv' }. Priviliged users may have additional options to specify URL metadata rather than having live-validation and metadata gathering performed from the Internet.

post/datasets/{doi}/urls

Path parameters

doistring required

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

Request body

urlstring required

Response

Metadata for the URL was saved and the response JSON indicates information populated for a file object based on the URL.

pathstring
sizeinteger
mimeTypestring
statusstring
digeststring
digestTypestring
descriptionstring
urlstring