HTTP REFERENCE
Create an artifact
Declare the exact filename, byte size and SHA-256 before uploading content.
POST/v1/artifacts
Start a file upload
Calculate size and SHA-256 from the bytes you will upload. Save the returned id, upload_url and complete_url.
What to do next
The example hash is illustrative. The upload helper calculates real values for you.
Read the step-by-step guide →
Send an Idempotency-Key. Keep the same key and body when retrying this operation.
Parameter and response reference
Parameters
authorizationheader · string | nullrequired
idempotency-keyheader · string | nullrequired
Request body
filenamestringrequired
Filename
Max length: 240 · Pattern: "^[^/\\\\\\x00-\\x1f]+$"
sizeintegerrequired
Size
Minimum: 1.0 · Maximum: 67108864.0
sha256stringrequired
Sha256
Pattern: "^[a-f0-9]{64}$"
retention_secondsinteger
Retention Seconds
Default: 604800 · Minimum: 3600.0 · Maximum: 7776000.0
Responses
201 Successful Response422 Validation Error