API Reference

Storage

Storage exposes files requested by an automation and produced by its jobs. Retrieve each file by storage id for seven days after its job reaches Done or Error; daily cleanup permanently deletes it after that retention window.

Endpoints

Stored files are requested in an Automation's storage contract and retained for seven days after each Job reaches Done or Error. A daily cleanup permanently deletes linked artifacts from older terminal jobs. Exchange a result.storage item id for a capability URL, treat that URL as sensitive, and fetch the gzip-compressed file directly without an API key during the retention window. Downloads keep their stored gzip compression: decompress the fetched bytes to obtain the requested file. Every member of a multi-file request uses its complete requested filename, including its extension. A single variable-format file may use an extensionless logical name. Browser Fleet packages multiple files into one zip archive and every result.storage entry points to that shared archive id.

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

Retrieve File

Returns the capability 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 inside a terminal job payload.

Example Request

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

200 OK

{
  "url": "https://convex.browserfleet.dev/api/storage/34a2b7c1..."
}

Retrieve File response fields
Field	Type	Description
url	string	Direct capability URL for the stored file. Anyone with the URL can fetch it, and the download streams the stored gzip-compressed bytes.

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