Skip to main content
GET
/
browser
/
sessions
/
{id}
/
fs
/
info
Stat Path
curl --request GET \
  --url https://api.example.com/browser/sessions/{id}/fs/info
{
  "path": "<string>",
  "type": "<string>",
  "size": 123,
  "mode": 123,
  "mtime": "<string>",
  "uid": 123,
  "gid": 123
}

​
Overview

Returns stat(2)-style metadata for a workspace path. Works for files, directories, and symlinks. Use this to check existence without pulling content, or to branch on type before calling the read vs. list endpoints.

​
Path Parameters

​
id
string
required
Browser session ID (UUID).

​
Query Parameters

​
path
string
required
Workspace-relative path to stat.

​
Example Request

curl -G "https://api.scrapengine.io/api/v1/browser/sessions/baa3f390-fa6e-4a24-b84a-a575a5f3a9c7/fs/info" \
  -H "Authorization: Bearer $SCRAPENGINE_API_KEY" \
  --data-urlencode "path=notes/todo.txt"

​
Response

​
Success Response (200)

​
path
string
The workspace-relative path that was stat’d.
​
type
string
One of file, dir, symlink, other.
​
size
integer
Size in bytes. For directories this is the directory entry size, not the tree size.
​
mode
integer
Unix mode.
​
mtime
string
Last modified timestamp (ISO 8601).
​
uid
integer
Owner UID.
​
gid
integer
Owner GID.
Example Response: 
{
  "path": "notes/todo.txt",
  "type": "file",
  "size": 11,
  "mode": 420,
  "mtime": "2026-04-24T09:12:44Z",
  "uid": 1000,
  "gid": 1000
}

​
Error Responses

StatusDescription
400Invalid path.
401Unauthorized — invalid or missing API key.
404Session or path not found.