Test Runs

Get a run recording download URL

View as Markdown

Get a short-lived signed URL that downloads the run’s screen recording (MP4), plus its file name and size. Use this instead of the streaming endpoint when the client should hand the link off rather than hold the bytes. Recordings become available after the run finishes; cancelled runs and runs without a recording return 404.

Authentication

AuthorizationBearer
API key authentication using Bearer token format

Path parameters

idstringRequiredformat: "uuid"
Test run ID

Response

Signed recording download URL
runIdstringformat: "uuid"
fileNamestring
mediaTypestring
sizeBytesdouble or null
Recording size in bytes, when R2 reports it
downloadUrlstringformat: "uri"
expiresIndouble
Lifetime of the URL in seconds
expiresAtdatetime

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error
504
Gateway Timeout Error