Skip to main content
POST
/
connectors
/
files
/
upload
/
request
Generate Presigned Upload URL
curl --request POST \
  --url https://production.runalloy.com/connectors/files/upload/request \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --data '
{
  "filename": "document.pdf",
  "mimeType": "application/pdf",
  "md5": "2942bfabb3d05332b66eb128e0842cff"
}
'
{
  "presignedUrl": {
    "md5": "KUK/q7PQUzK2brEo4IQs/w==",
    "presignedUrl": "https://alloy-user-files.s3.us-east-1.amazonaws.com/651eb6e11d156e0d7a42c59d_document.pdf",
    "type": "new",
    "s3Key": "651eb6e11d156e0d7a42c59d_document.pdf"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-api-version
string
default:2025-09
required

API version

Body

application/json
​
filename
string
required

Name of the file to be uploaded

Example:

"document.pdf"

​
mimeType
string
required

MIME type of the file

Example:

"application/pdf"

​
md5
string
required

MD5 hash of the file (hex or base64 format)

Example:

"2942bfabb3d05332b66eb128e0842cff"

Response

Presigned URL generated successfully

​
presignedUrl
object