Complete multipart upload

POST 
/uploads/complete-multipart.json

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.

Request

application/json

Body

unique_identifier stringrequired

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

parts arrayrequired

All of the part numbers and their corresponding ETags that have been uploaded must be provided.

Responses

200

external upload initialized

application/json

Schema

Schema

id integerrequired
url stringrequired
original_filename stringrequired
filesize integerrequired
width integerrequired
height integerrequired
thumbnail_width integerrequired
thumbnail_height integerrequired
extension stringrequired
short_url stringrequired
short_path stringrequired
retain_hours stringnullrequired
human_filesize stringrequired
dominant_color stringnullrequired

Example (from schema)

{
  "id": 0,
  "url": "string",
  "original_filename": "string",
  "filesize": 0,
  "width": 0,
  "height": 0,
  "thumbnail_width": 0,
  "thumbnail_height": 0,
  "extension": "string",
  "short_url": "string",
  "short_path": "string",
  "human_filesize": "string"
}

Loading...