> ## 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.

# List Session Events

List events related to a session (aggregated from all executions).

## **POST** `/revisions/:id/data/query` (Command: `list_session_events`)

### Request Body

| Parameter       | Type   | Required | Description                            |
| :-------------- | :----- | :------- | :------------------------------------- |
| `engine`        | string | Yes      | Must be `workflow_blobhub`.            |
| `command`       | string | Yes      | Must be `list_session_events`.         |
| `session_id`    | string | Yes      | The ID of the session.                 |
| `created_since` | string | No       | Filter events created after timestamp. |

### Response

| Parameter        | Type  | Description            |
| :--------------- | :---- | :--------------------- |
| `session_events` | array | List of event objects. |

### Example

<CodeGroup>
  ```json Request theme={null}
  {
    "engine": "workflow_blobhub",
    "command": "list_session_events",
    "session_id": "sess_001"
  }
  ```

  ```json Response theme={null}
  {
    "session_events": []
  }
  ```
</CodeGroup>

### See also

* [BlobHub Worker](/worker/introduction) — the worker polls this command to react to
  `session_object_modified`, `session_object_deleted`, and `session_thread_item_posted` events.