session_files

session_files

Every file this session has.

MCP tool	session_files
HTTP	POST /files/list

The browser's downloads and the session's kept files as one list, newest first, each entry saying which it is. A name in both resolves to the kept one. Works after the browser is gone, returning the kept files alone.

Parameters

Name	Type	Required	Default	Notes
session	string	no	—	Whose kept files. Defaults to the caller's session name if the request carries one, else the shared 'global' session.
session_id	string	yes over HTTP	—	Omit over MCP when the server is holding your browser.

Returns

Field	Type	Notes
component	string
session_id	string	The browser these downloads belong to, if any.
session	string	The session whose kept files these are.
count	integer
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

session_files()

HTTP

curl -X POST $SELENIUM_FLOW/files/list \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "session_id": "…"
  }'

---

← All actions · Installing · Deployment