Skip to main content
Page items in a thread session object. Items are sorted by created_at.

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

​
Request Body

ParameterTypeRequiredDescription
enginestringYesMust be workflow_blobhub.
commandstringYesMust be list_session_thread_items.
session_idstringYesThe ID of the session.
aliasstringYesAlias of the thread session object.
ascendingbooleanNoSort direction. Default false (newest first).
created_sincestringNoReturn items with created_at > created_since.
created_beforestringNoReturn items with created_at < created_before.

​
Response

ParameterTypeDescription
itemsarrayPage of thread items sorted by created_at.
Page size is server-controlled. Use created_since to tail forward from the newest known item; use created_before to paginate backward from the oldest known item.

​
Errors

  • invalid_thread_envelope — the alias does not exist or its value.type is not "thread".

​
Example

{
  "engine": "workflow_blobhub",
  "command": "list_session_thread_items",
  "session_id": "sess_001",
  "alias": "onboarding_thread",
  "ascending": false
}

{
  "items": [
    {
      "id": "itm_01H...",
      "session_id": "sess_001",
      "revision_id": "rev_001",
      "alias": "onboarding_thread",
      "created_at": "2026-05-22T22:00:01.000000+00:00",
      "user_id": "usr_002",
      "content": [{ "type": "text", "text": "Hi there!" }]
    },
    {
      "id": "itm_01G...",
      "session_id": "sess_001",
      "revision_id": "rev_001",
      "alias": "onboarding_thread",
      "created_at": "2026-05-22T22:00:00.000000+00:00",
      "user_id": "usr_001",
      "content": [{ "type": "text", "text": "Hello, world." }]
    }
  ]
}

​
See also

  • BlobHub Worker — thread items — metadata.type discriminates worker-posted items (text, tool_call, tool_result, thinking, status, turn_end, pending_prompt, pending_prompt_resolved) from plain user posts.