List Session Objects

List objects stored in a session, with prefix/delimiter navigation and cursor pagination.

POST `/revisions/:id/data/query` (Command: `list_session_objects`)

Request Body

Parameter	Type	Required	Description
`engine`	string	Yes	Must be `workflow_blobhub`.
`command`	string	Yes	Must be `list_session_objects`.
`session_id`	string	Yes	The ID of the session.
`prefix`	string	No	Restrict to aliases under this path prefix (relative to the session). Default `""` (all).
`delimiter`	string	No	When set (typically `"/"`), returns one level only plus `common_prefixes` (“folders”).
`cursor`	string	No	Opaque page cursor from a previous response’s `cursor`. Omit for the first page.
`limit`	integer	No	Max objects per page, 1–1000 (out-of-range → 400). Default `1000`.

Response

Parameter	Type	Description
`objects`	array	Objects in this page, each `{ "alias", "updated_at", "size" }`.
`common_prefixes`	array	Child “folder” prefixes (only present when `delimiter` is set).
`cursor`	string	Opaque cursor for the next page, or `null` when there are no more pages.

Each entry carries its alias, the storage updated_at timestamp, and size in bytes. Objects of type "thread" and "graph" appear here like any other object (their envelopes only — items and elements live in separate stores). updated_at is the one timestamp on this API written by object storage rather than by the platform, so it is the only one spelled with a +00:00 offset and without sub-second precision. The same object’s envelope carries its own updated_at in the …Z form every other endpoint uses; the two describe the same write. Aliases are paths. An alias is a /-separated path (e.g. missions/a1b2c3/graph); use prefix to scope a subtree and delimiter: "/" to browse one level as folders. See Session Objects for the full alias grammar. Pagination. Pass the response cursor back as the request cursor to fetch the next page; stop when cursor is null. The cursor is opaque — send it back verbatim and keep prefix/delimiter unchanged. An invalid or expired cursor returns 400 invalid_cursor. This is the same cursor + limit contract used by every list_* command (session objects, graph elements, thread items, session events, execution events).

Example

{
  "engine": "workflow_blobhub",
  "command": "list_session_objects",
  "session_id": "sess_001",
  "prefix": "missions/a1b2c3/",
  "delimiter": "/",
  "limit": 100
}

{
  "status": "success",
  "objects": [
    { "alias": "missions/a1b2c3/graph", "updated_at": "2026-07-12T10:00:00+00:00", "size": 1234 }
  ],
  "common_prefixes": [ "missions/a1b2c3/cells/" ],
  "cursor": null
}

Overview

Workflow

Scheduler

ONNX

List Session Objects

POST `/revisions/:id/data/query` (Command: `list_session_objects`)

Request Body

Response

Example

​POST /revisions/:id/data/query (Command: list_session_objects)

​Request Body

​Response

​Example

POST `/revisions/:id/data/query` (Command: `list_session_objects`)

Request Body

Response

Example