---
title: "Initiate Upload"
method: POST
path: "/account/articles/{article_id}/files"
tags: ["articles"]
---

# Initiate Upload

`POST /account/articles/{article_id}/files`

Initiate a new file upload within the article. Either use the link property to point to an existing file that resides elsewhere and will not be uploaded to Figshare or use the other 3 parameters (md5, name, size).

## Path parameters

- `article_id` integer, required

## Query parameters

- `page` integer
- `page_size` integer
- `limit` integer
- `offset` integer

## Request body

- FileCreator
  - `link` string — Url for an existing file that will not be uploaded to Figshare
  - `md5` string — MD5 sum pre-computed on client side.
  - `name` string — File name including the extension; can be omitted only for linked files.
  - `size` integer — File size in bytes; can be omitted only for linked files.
  - `folder_path` string — Unix-style directory path of the file; only available if the file was uploaded within a folder structure

## Response `201`

Created

- Location
  - `location` string, url, required — Url for item

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity. Parameters missing or incorrect
- `500` — Internal Server Error

---

[API](https://skmtc.net/figshare/apis/figshare-api.md) · [All operations](https://skmtc.net/figshare/apis/figshare-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/figshare/figshare-api/versions/9dfb419f4430/schema)