Skip to main content
Paginate elements in a graph session object. Elements are sorted by created_at by default; sorting switches to updated_at when updated_since is provided.

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

​
Request Body

ParameterTypeRequiredDescription
enginestringYesMust be workflow_blobhub.
commandstringYesMust be list_session_graph_elements.
session_idstringYesThe ID of the session that owns the graph envelope.
aliasstringYesAlias of the graph session object.
typestringNoFilter by element type: "vertex" or "edge". Omit to return both.
ascendingbooleanNoSort direction. Default false (descending — most-recently-created or most-recently-updated first).
cursorstringNoOpaque pagination cursor returned by a previous call.
updated_sincestringNoReturn only elements with updated_at > updated_since (ISO 8601). Useful for incremental delta syncs.
ids_onlybooleanNoWhen true, returns lightweight element_ids objects (element_id, type, rev) instead of full element objects. Useful for reconciliation.
updated_since — pass the timestamp of the last-known mutation to retrieve only elements added or changed since that point. This is the recommended pattern for incremental client syncs after receiving a session_graph_changed event. ids_only — when you only need to know which elements exist (e.g. to reconcile a local cache), set ids_only: true. The response switches from elements to element_ids (lightweight objects with element_id, type, and rev) and is significantly smaller for large graphs.

​
Response

When ids_only is false (default):
ParameterTypeDescription
elementsarray of objectPage of graph elements. Sorted by created_at normally; by updated_at when updated_since is set.
cursorstring or nullPagination cursor; null when this is the last page.
When ids_only is true:
ParameterTypeDescription
element_idsarray of objectPage of lightweight element records (element_id, type, rev) sorted by created_at.
cursorstring or nullPagination cursor; null when this is the last page.
Page size is server-controlled.

​
Errors

  • invalid_graph_envelope — the alias does not exist or its value.type is not "graph".
  • invalid_cursor — the cursor is malformed or has expired.

​
Example

{
  "engine": "workflow_blobhub",
  "command": "list_session_graph_elements",
  "session_id": "sess_001",
  "alias": "task_graph",
  "type": "vertex",
  "ascending": false,
  "updated_since": "2026-06-06T10:00:00.000000+00:00"
}

​
See also