Upload

Request Multipart Upload Part

Request a presigned URL for a specific part of a multipart upload

This endpoint is only needed for multipart uploads, including any files larger than 5GB.

POST/upload/request/multipart
AuthorizationBearer <token>

App-specific auth token. Bearer authentication header of the form Bearer , where is your auth token.

In: header

Multipart upload part request

pending_upload_idstring

Pending upload ID from the initial request

part_numberinteger

Part number you want to upload

Example1
content_lengthinteger

Size of this part in bytes

Example52428800

Response Body

application/json

application/json

application/json

curl -X POST "https://app.buildstash.com/api/v1/upload/request/multipart" \  -H "Content-Type: application/json" \  -d '{    "pending_upload_id": "string",    "part_number": 1,    "content_length": 52428800  }'
{
  "message": "Generated pre-signed URL for part 1",
  "part_number": 1,
  "part_presigned_url": "string"
}
{
  "message": "Error generating pre-signed URL for part"
}
{
  "message": "Unauthorized"
}

Notes

  • Part numbers must be sequential starting from 1
  • Each part must be uploaded exactly once
  • The ETag from each upload must be saved for the final verification step
  • Parts can be uploaded in parallel for better performance
  • If a part upload fails, you can retry uploading to the same presigned URL