---
title: "POST /files"
method: POST
path: "/files"
tags: ["files"]
---

# POST /files

`POST /files`

Upload data

## Query parameters

- `dataObjectId` string, required
- `storageBucketId` string, required
- `bagId` string, required

## Response `201`

Created

- object
  - `id` string

## Other responses

- `400` — Bad request

## Changes

> 16 revisions in range; 1 could not be searched.

- **2022-10-25** `4837213347f3` — 3 breaking, 3 warning
  - added the new required `query` request parameter `bagId`
  - added the new required `query` request parameter `dataObjectId`
  - added the new required `query` request parameter `storageBucketId`
  - removed the request property `bagId`
  - …2 more
- **2021-12-17** `442811c13fe1` — 3 breaking, 3 warning
  - added the new required request property `bagId`
  - added the new required request property `dataObjectId`
  - added the new required request property `storageBucketId`
  - deleted the `query` request parameter `bagId`
  - …2 more

[Change history](https://skmtc.dev/joystream/apis/storage-node-api/changes/files/post.md)

---

[API](https://skmtc.dev/joystream/apis/storage-node-api.md) · [All operations](https://skmtc.dev/joystream/apis/storage-node-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/joystream/storage-node-api/revisions/c0bd5ec75039/schema)