Skip to main content
POST
/
s3
/
upload-url
Get a presigned URL for uploading a file to S3
curl --request POST \
  --url https://api.example.com/s3/upload-url \
  --header 'Content-Type: application/json' \
  --data '
{
  "mimeType": "<string>",
  "size": 123
}
'
{
  "url": "https://example-bucket.s3.amazonaws.com/path/to/file.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&...",
  "s3ObjectId": "123e4567-e89b-12d3-a456-426614174000"
}

Body

application/json
​
mimeType
string
required

The MIME type of the object

​
size
number
required

The size of the object

Response

201 - application/json

Returns a presigned URL and S3 object ID for uploading a file

​
url
string
required

The presigned URL to upload the file to

Example:

"https://example-bucket.s3.amazonaws.com/path/to/file.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&..."

​
s3ObjectId
string
required

The created S3 object record

Example:

"123e4567-e89b-12d3-a456-426614174000"