Skip to main content
POST
Upload file

Authorizations

Authorization
string
header
required

API key issued from Settings → API Keys. Pass as Authorization: Bearer <key>.

Body

multipart/form-data
file
file
required

Binary file field

purpose
enum<string>

Optional lifecycle marker. run-input marks a retry-safe temporary run pre-upload reaped after 24 hours. builder-attachment marks a Studio builder intermediary (any MIME) with the same TTL.

Available options:
run-input,
builder-attachment

Response

Uploaded file

id
string
required
filename
string
required
contentType
string | null
required
size
integer | null
required
Required range: -9007199254740991 <= x <= 9007199254740991
createdAt
required
purpose
string | null

Optional lifecycle marker. run-input marks a retry-safe temporary run pre-upload reaped after 24 hours. builder-attachment marks a Studio builder intermediary (any MIME) with the same TTL. Omitted/null means a durable reusable file.