list_downloads

session://files/downloads

This session's browser downloads.

MCP resource	session://files/downloads
HTTP	GET /files/downloads

Newest first, read from the browser itself. Answers empty rather than failing when there is no browser open; a Grid failure from one that is open is a real fault and is not hidden.

Parameters

This action takes no parameters.

Every call names its session: an X-Session-Key header, or ?session=<name>. Sending both is refused. See Sessions.

Returns

Field	Type	Notes
session	string
folder	string
uri	string
count	integer
browser	boolean	Present on downloads only: whether a browser is open to read them from.
files	array

Errors

Status	Means
400	The request cannot succeed as sent — an unusable name, or a server with no FLOW_DATA_DIR to keep files in. Do not retry it unchanged.
401	Missing or wrong bearer token.
404	No such browser session, or no such file in it. It ended, the Grid reaped it, or the id was never real.
500	Something failed that this server did not expect.
503	The Grid could not serve this — unreachable, or failing. Worth retrying after a wait.

Over MCP the same failures arrive as a tool error.

Example

MCP

read session://files/downloads

read_resource(uri="session://files/downloads")

HTTP

curl -X GET $SELENIUM_FLOW/files/downloads \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Session-Key: $SESSION"

---

← All actions · Installing · Deployment