Skip to main content
GET
List Workspace Directory

Headers

x-user-id
string
required

Caller's user ID. Temporary header-based identity; will be replaced by JWT auth.

Query Parameters

agent_id
string
required
session_id
string
required
path
string
default:""

Absolute path, or one relative to the workspace root. Empty lists the workspace root itself.

Response

Successful Response

name
string
required

The entry name, without any leading directory.

is_dir
boolean
required

Whether the entry is itself a directory.

size_bytes
integer | null

File size in bytes. Always null for a directory, and null for a file the backend could not stat.

updated_at
number | null

Last modification time as a Unix timestamp.