Confirm Presigned Upload

Confirms that a file was successfully uploaded to S3 using presigned URL

POST /api/storage/buckets/{bucketName}/objects/{objectKey}/confirm-upload

Confirm Presigned Upload

cURL

curl --request POST \
  --url https://api.example.com/api/storage/buckets/{bucketName}/objects/{objectKey}/confirm-upload \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "size": 102400,
  "contentType": "image/jpeg",
  "etag": "9bb58f26192e4ba00f01e2e7b136bbd8"
}
'

201

{
  "bucket": "avatars",
  "key": "user123.jpg",
  "size": 102400,
  "uploadedAt": "2024-01-15T10:30:00Z",
  "url": "/api/storage/buckets/avatars/objects/user123.jpg",
  "mimeType": "image/jpeg"
}

Authorizations

x-api-key · string · header · required

Path Parameters

bucketName · string · required

Pattern: ^[a-zA-Z0-9_-]+$

objectKey · string · required

Body

application/json

size · integer · required

File size in bytes

Example:

102400

contentType · string

MIME type of the file

Example:

"image/jpeg"

etag · string

S3 ETag of the uploaded object (optional)

Example:

"9bb58f26192e4ba00f01e2e7b136bbd8"

Response

201

application/json

Upload confirmed successfully

bucket · string · required

Name of the bucket containing the object

Example:

"avatars"

key · string · required

Unique key identifying the object within the bucket

Example:

"user123.jpg"

size · integer · required

Size of the file in bytes

Example:

102400

uploadedAt · string<date-time> · required

ISO timestamp when the file was uploaded

Example:

"2024-01-15T10:30:00Z"

url · string · required

URL to download the file

Example:

"/api/storage/buckets/avatars/objects/user123.jpg"

mimeType · string

MIME type of the file

Example:

"image/jpeg"