API Reference

Storage

Retrieve files produced by your jobs using their storage IDs. Files are kept for seven days after a job finishes.

Endpoints

Files requested in an automation's storage array are kept for seven days after the job finishes. Exchange each result.storage ID for a signed download URL. The URL is valid for one hour; anyone who has it can download the file. Keep storage IDs and download URLs private.

GEThttps://api.browserfleet.dev/rest/public/storage?storageId={storageId}

Retrieve File

Returns a signed download URL for one stored job file.

Retrieve File request fields
Field	Location	Type	Required	Description
storageId	Query String	string	Yes	Storage id returned as result.storage[].id of a Done job.

Example Request (cURL)

curl "https://api.browserfleet.dev/rest/public/storage?storageId=4f9a2c7e1b3d4a5f8e6c0b9d2a7f1e3c" \
  -H "Authorization: Bearer $BROWSER_FLEET_API_KEY"

200 OK Response (JSON)

{
  "url": "https://.../4f9a2c7e1b3d4a5f8e6c0b9d2a7f1e3c?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=..."
}

Retrieve File response fields
Field	Type	Description
url	string	Signed download URL for the stored file, valid for one hour. Anyone with the URL can download the file; request a new URL after it expires.

Retrieve File error responses
Status	Body	Meaning
400	{ "error": "Missing storageId" }	The storageId query parameter is empty or absent.
401	{ "error": "Invalid API key" }	The API key is missing or invalid.
404	{ "error": "File not found or deleted after the 7-day retention period" }	The storage id is invalid or unknown, or its file was deleted after its seven-day retention window.