Skip to main content
POST
/
apps
/
upload-url
Upload a Build
curl --request POST \
  --url https://api.docketqa.com/apps/upload-url \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "filename": "<string>",
  "platform": "<string>",
  "file_size": 123,
  "content_type": "<string>"
}
'
Get a 15-minute presigned URL for uploading a build binary. PUT the binary to s3_presigned_url, then pass the returned s3_key to Create App or Create Build. Files are capped at 1 GB.

Request body

filename
string
required
Original filename. Extension must match the platform.
platform
string
required
"android" or "ios".
file_size
integer
required
Size in bytes. Must be > 0 and ≤ 1073741824.
content_type
string
Defaults to "application/octet-stream". Must match the Content-Type header you send on the S3 PUT.
PlatformAllowed extensions
android.apk, .xapk, .apks, .apkm
ios.zip (zipped simulator .app bundle, not .ipa)

Response

{
  "s3_presigned_url": "https://docket-blobs.s3.amazonaws.com/files/2/...&X-Amz-Signature=...",
  "s3_key": "files/2/4f8e1c2a-..._acme.apk",
  "content_type": "application/vnd.android.package-archive",
  "filename": "acme.apk"
}