---
title: "Abort multipart upload"
method: POST
path: "/uploads/abort-multipart.json"
tags: ["Uploads"]
---

# Abort multipart upload

`POST /uploads/abort-multipart.json`

This endpoint aborts the multipart upload initiated with /create-multipart.
This should be used when cancelling the upload. It does not matter if parts
were already uploaded into the external storage provider.

You must have the correct permissions and CORS settings configured in your
external provider. We support AWS S3 as the default. See:

https://meta.discourse.org/t/-/210469#s3-multipart-direct-uploads-4.

An external file store must be set up and `enable_direct_s3_uploads` must
be set to true for this endpoint to function.

## Request body

- object
  - `external_upload_identifier` string, required — The identifier of the multipart upload in the external storage provider. This is the multipart upload_id in AWS S3.

## Response `200`

external upload initialized

- object
  - `success` string, required

---

[API](https://skmtc.dev/discourse/apis/discourse-api-documentation.md) · [All operations](https://skmtc.dev/discourse/apis/discourse-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/discourse/discourse-api-documentation/revisions/2fd8fd2d6fd0/schema)