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

# Download Session Object

Download an object from the session storage.

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

### Request Body

| Parameter    | Type   | Required | Description                        |
| :----------- | :----- | :------- | :--------------------------------- |
| `engine`     | string | Yes      | Must be `workflow_blobhub`.        |
| `command`    | string | Yes      | Must be `download_session_object`. |
| `session_id` | string | Yes      | The ID of the session.             |
| `alias`      | string | Yes      | Alias of the object to download.   |

### Response

| Parameter | Type   | Description                      |
| :-------- | :----- | :------------------------------- |
| `object`  | object | The retrieved object's envelope. |

The envelope, not the bare value: `revision_id`, `session_id`, `alias` and `updated_at` sit alongside the
stored `value`. Everything the notes below say about `object.value` reads out of that key.

> When `object.value.type` is `"thread"`, the returned envelope contains only `attributes` and
> `metadata`. Items are fetched separately via `list_session_thread_items` / `get_session_thread_item`.

> When `object.value.type` is `"graph"`, the returned envelope contains only `attributes` and
> `metadata`. Elements are fetched separately via the six graph commands. See the
> [graph session object](/blob-types/workflow/session-objects/graph/introduction) for the element schema.

### Example

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

  ```json Response theme={null}
  {
    "status": "success",
    "object": {
      "revision_id": "rev_001",
      "session_id": "sess_001",
      "alias": "config",
      "updated_at": "2026-07-12T10:00:00.000000Z",
      "value": { "debug": true }
    }
  }
  ```
</CodeGroup>