Skip to main content
Fetch multiple elements from a graph session object by id in a single call.

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

Ids that do not exist in the graph are silently omitted from the response (no error is raised for missing ids). This makes the command safe to use for cache-warming after receiving a session_graph_changed event: pass all changed element_id values from the event’s changes array and the server returns whichever still exist.

​
Request Body

ParameterTypeRequiredDescription
enginestringYesMust be workflow_blobhub.
commandstringYesMust be get_session_graph_elements.
session_idstringYesThe ID of the session that owns the graph envelope.
aliasstringYesAlias of the graph session object.
element_idsarray of stringYesThe ids of the vertices or edges to retrieve.

​
Response

ParameterTypeDescription
elementsarray of objectThe retrieved elements. Missing ids are omitted; order is not guaranteed.

​
Errors

  • invalid_graph_envelope — the alias does not exist or its value.type is not "graph".

​
Example

{
  "engine": "workflow_blobhub",
  "command": "get_session_graph_elements",
  "session_id": "sess_001",
  "alias": "task_graph",
  "element_ids": ["task:1", "task:2", "e:1"]
}

​
See also