Skip to main content
GET
/
browser
/
sessions
/
{id}
/
files
List Session Files
curl --request GET \
  --url https://api.example.com/browser/sessions/{id}/files
{
  "files": [
    {}
  ]
}

​
Overview

Returns every file currently present in the session’s uploads directory, in no guaranteed order. Uploaded files persist for the life of the session and can be referenced by name in uploadFile task actions.

​
Path Parameters

​
id
string
required
Browser session ID (UUID).

​
Example Request

curl -G "https://api.scrapengine.io/api/v1/browser/sessions/baa3f390-fa6e-4a24-b84a-a575a5f3a9c7/files" \
  -H "Authorization: Bearer $SCRAPENGINE_API_KEY"

​
Response

​
Success Response (200)

​
files
array
Array of uploaded file records. Each entry contains:
  • filename (string) — name in the uploads directory.
  • size (integer) — size in bytes.
  • uploadedAt (string) — ISO 8601 timestamp of the upload.
Example Response: 
{
  "files": [
    {
      "filename": "resume.pdf",
      "size": 20813,
      "uploadedAt": "2026-04-24T09:12:44Z"
    }
  ]
}

​
Error Responses

StatusDescription
401Unauthorized — invalid or missing API key.
404Session not found or not owned by the caller.