Sign in

v3

latestOpenAPI 3.1.0MIT2026-07-31930688.4 KB
Uploads

Complete multipart upload

Completes the multipart upload in the external store, and copies the file from its temporary location to its final location in the store. All of the parts must have been uploaded to the external storage provider. An Upload record will be completed in most cases once the file is copied to its final location.

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.

post/uploads/complete-multipart.json

Request body

unique_identifierstring required

The unique identifier returned in the original /create-multipart request.

Example request

{
  "unique_identifier": "66e86218-80d9-4bda-b4d5-2b6def968705",
  "parts": [
    {
      "part_number": 1,
      "etag": "0c376dcfcc2606f4335bbc732de93344"
    },
    {
      "part_number": 2,
      "etag": "09ert8cfcc2606f4335bbc732de91122"
    }
  ]
}

Response

external upload initialized

idinteger required
urlstring required
original_filenamestring required
filesizeinteger required
widthinteger required
heightinteger required
thumbnail_widthinteger required
thumbnail_heightinteger required
extensionstring required
short_urlstring required
short_pathstring required
retain_hoursstring nullable required
human_filesizestring required
dominant_colorstring nullable