Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.blobhub.io/llms.txt

Use this file to discover all available pages before exploring further.

Session Events are tracking payloads asynchronously generated by Session lifecycle updates rather than intense workflow executions. They primarily inform listeners when data states globally shift within the session memory parameters.

​
Shared Event Format

All session events conform to the following base structure: 
{
  "id": "uuid-event-id",
  "revision_id": "uuid-workflow-revision",
  "session_id": "uuid-active-session",   
  "created_at": 1714150000000,
  "type": "event_type_string",
  ... // Dynamic event-specific properties
}

​
Event Types

​
session_object_modified

Fired when a upload_session_object call is made against the Session, modifying semi-persistent object values securely within the active envelope. Extremely useful for reactive applications polling or streaming state updates directly. 
{
  "id": "uuid-event-id",
  "revision_id": "uuid-workflow-revision",
  "session_id": "uuid-active-session",   
  "created_at": 1714150000000,
  "type": "session_object_modified",
  "session_object": {
    "alias": "my_stored_configuration_data"
  }
}

​
session_thread_item_posted

Fired when a post_session_thread_item call adds an item to a thread session object. Listeners can re-fetch the thread tail via list_session_thread_items with created_since set to the previously known created_at. 
{
  "id": "uuid-event-id",
  "revision_id": "uuid-workflow-revision",
  "session_id": "uuid-active-session",
  "created_at": 1714150000000,
  "type": "session_thread_item_posted",
  "alias": "onboarding_thread",
  "item_id": "uuid-of-the-new-item"
}