---
title: "List multipart uploads"
method: POST
path: "/bus/multipart/listuploads"
tags: ["bus"]
---

# List multipart uploads

`POST /bus/multipart/listuploads`

Lists all ongoing multipart uploads.

## Request body

- object
  - `bucket` string — The name of the bucket.
  - `prefix` string — Filter uploads by key prefix
  - `keyMarker` string — Key to start listing from
  - `uploadIDMarker` string, byte — Upload ID to start listing from
  - `limit` integer — Maximum number of uploads to return

## Response `200`

Successfully listed multipart uploads

- object
  - `hasMore` boolean — Whether there are more uploads to fetch
  - `nextMarker` string — The key marker for the next page of results
  - `nextUploadIDMarker` string, byte — The upload ID marker for the next page of results
  - `uploads` object[]
    - `bucket` string — The name of the bucket
    - `encryptionKey` string — The encryption key used for this upload
    - `key` string — The key of the object
    - `uploadID` string, byte — The ID of the multipart upload
    - `createdAt` string, date-time — When the upload was created

## Changes

- **2024-12-18** `922f156353c9` — 1 info
  - api tag `bus` added
- **2024-12-17** `a3a866454789` — 1 info
  - endpoint added
- **2024-12-09** `f062c35d8f47` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/siafoundation/apis/renterd-api/changes/bus/multipart/listuploads/post.md)

---

[API](https://skmtc.dev/siafoundation/apis/renterd-api.md) · [All operations](https://skmtc.dev/siafoundation/apis/renterd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/siafoundation/renterd-api/revisions/184a3d5207da/schema)