---
title: "Stage a file submission by URL"
method: POST
path: "/datasets/{doi}/urls"
tags: ["files"]
---

# Stage a file submission by URL

`POST /datasets/{doi}/urls`

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.

## Path parameters

- `doi` string, required

## Request body

- UrlJson
  - `url` string, required

## Response `201`

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

- object
  - `_links` object
    - `self` HalLink
      - `href` string, uri, required
    - `stash:dataset` HalLink
      - `href` string, uri, required
    - `stash:version` HalLink
      - `href` string, uri, required
    - `stash:files` HalLink
      - `href` string, uri, required
    - `stash:download` HalLink
      - `href` string, uri, required
    - `curies` HalCurie[]
      - `name` string, required
      - `href` string, uri, required
      - `templated` boolean, required
  - `path` string
  - `size` integer
  - `mimeType` string
  - `status` string
  - `digest` string
  - `digestType` string
  - `description` string
  - `url` string

## Other responses

- `401`
- `404`
- `406`

---

[API](https://skmtc.net/datadryad/apis/dryad-api.md) · [All operations](https://skmtc.net/datadryad/apis/dryad-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadryad/dryad-api/revisions/5e35babfb8d2/schema)