list_files - kubed-io/selenium-flow GitHub Wiki
Files' own listing, and its three folders.
| MCP resource | workspace://files |
| HTTP | GET /files |
Everything kept in Files, newest first, plus a count for workspace://files/screenshots, workspace://files/recordings and workspace://files/downloads — each its own listing, fetched separately so a caller who only wants to know whether there is anything to look at need not pay for either.
This action takes no parameters.
Every call names its workspace: an X-Workspace header, or
?workspace=<name>. Sending both is refused. See Workspaces.
| Field | Type | Notes |
|---|---|---|
workspace |
string | The workspace these files belong to. |
count |
integer | |
files |
array | |
folders |
array |
| Status | Means |
|---|---|
400 |
The request cannot succeed as sent — an unusable name, or a server with no 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.
MCP
read workspace://files
read_resource(uri="workspace://files")
HTTP
curl -X GET $SELENIUM_FLOW/files \
-H "Authorization: Bearer $TOKEN" \
-H "X-Workspace: $WORKSPACE"