POST
/
upload
/
request
Request Upload
curl --request POST \
  --url https://app.buildstash.com/api/v1/upload/request \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "structure": "file",
  "platform": "<string>",
  "stream": "<string>",
  "source": "<string>",
  "primary_file": {
    "filename": "<string>",
    "size_bytes": 123
  },
  "version_component_1_major": "<string>",
  "version_component_2_minor": "<string>",
  "version_component_3_patch": "<string>"
}'
{
  "pending_upload_id": "<string>",
  "primary_file": {
    "chunked_upload": true,
    "chunked_number_parts": 123,
    "chunked_part_size_mb": 123,
    "presigned_data": {
      "url": "<string>",
      "headers": {
        "Content-Type": "<string>",
        "Content-Length": "<string>",
        "Content-Disposition": "<string>"
      }
    }
  },
  "expansion_files": [
    {
      "chunked_upload": true,
      "chunked_number_parts": 123,
      "chunked_part_size_mb": 123,
      "presigned_data": {
        "url": "<string>",
        "headers": {
          "Content-Type": "<string>",
          "Content-Length": "<string>",
          "Content-Disposition": "<string>"
        }
      }
    }
  ]
}
This endpoint initiates the build upload process by requesting presigned URLs. The response will indicate whether single-part or multipart upload is possible. Multipart is always required for files larger than 5GB.

​
Overview

The upload request endpoint is the first step in uploading a new build. It provides all key build information, and returns a presigned URL for direct upload or multipart upload information for larger files.

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Upload request details

The body is of type object.

Response

200
application/json

Upload request successful

The response is of type object.