List a directory in the session's workspace [read]

Changed on

Returns up to 200 entries (name, type, size, mtime) for a directory under /data/workspace. Dotfiles are excluded by default; pass ?hidden=true to include them. Only regular files and directories are listed: symlinks, FIFOs, sockets and devices never are. Paths are confined to the workspace root; '..' and absolute paths outside the root return 400 invalid_path. A parked or suspended pod returns 409 session_parked — send a message to wake it.

get/sessions/{id}/workspace/files

Request

  • Base URL
    https://api.agentsky.dev/v1
  • URL
    https://api.agentsky.dev/v1/sessions/{id}/workspace/files
  • Auth
    HTTP bearer

Path parameters

idstring required

The session id

Query parameters

pathstring

Relative or absolute path under workspace root; defaults to root

hiddenboolean

Include dotfiles (default false)

Response

OK

pathstring
truncatedboolean
limitinteger

Changes