Sign in

v3

latestOpenAPI 3.1.0MIT2026-07-31930688.4 KB
Uploads

Completes a direct external upload

Completes an external upload initialized with /get-presigned-put. The file will be moved from its temporary location in external storage to a final destination in the S3 bucket. An Upload record will also be created in the database in most cases.

If a sha1-checksum was provided in the initial request it will also be compared with the uploaded file in storage to make sure the same file was uploaded. The file size will be compared for the same reason.

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-external-upload.json

Request body

unique_identifierstring required

The unique identifier returned in the original /generate-presigned-put request.

for_private_messagestring

Optionally set this to true if the upload is for a private message.

for_site_settingstring

Optionally set this to true if the upload is for a site setting.

pastedstring

Optionally set this to true if the upload was pasted into the upload area. This will convert PNG files to JPEG.

Example request

{
  "unique_identifier": "66e86218-80d9-4bda-b4d5-2b6def968705",
  "for_private_message": "true",
  "for_site_setting": "true",
  "pasted": "true"
}

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