Skip to main content
Begin an explicit immutable build upload

Authorizations

Authorization
string
header
required

Opaque control credential

Headers

Idempotency-Key
string
required
Required string length: 8 - 128
Pattern: ^[A-Za-z0-9._:-]+$

Path Parameters

projectId
string
required
Pattern: ^prj_[0-9a-z]{12,32}$

Body

application/json
buildHash
string
required
Pattern: ^sha256:[0-9a-f]{64}$
artifactDigest
string
required
Pattern: ^sha256:[0-9a-f]{64}$
bytes
integer
required
Required range: 0 < x <= 67108864
advanceEnvironmentId
string
Pattern: ^env_[0-9a-z]{12,32}$
expectedEnvironmentVersion
integer
Required range: -9007199254740991 <= x <= 9007199254740991

Response

Existing build upload

schemaVersion
enum<number>
required
Available options:
1
attempt
object
required
method
enum<string>
required
Available options:
PUT
uploadUrl
string<uri>
required
Maximum string length: 4096
headers
object
required
expiresAtMs
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991