---
title: "Browse south explore session"
method: PUT
path: "/api/history/{historyId}/explore/{sessionId}"
tags: ["History Queries"]
---

# Browse south explore session

`PUT /api/history/{historyId}/explore/{sessionId}`

## Request

- Base URL: `http://localhost:2223`
- URL: `http://localhost:2223/api/history/{historyId}/explore/{sessionId}`
- Auth: none required
- TypeScript: <https://skmtc.dev/optimistiksas/apis/oibus-api/docs/api/history/:historyId/explore/:sessionId/put.ts> (a function with typed inputs; its response is checked against the schema)

Browse (expand) an entry within a history query explore session

## Path parameters

- `historyId` string, required
- `sessionId` string, required

## Request body

- SouthExploreBrowseCommand: Command body to browse (expand) an entry within an explore session.
  - `parentId` string, nullable, required: The id of the entry to expand, or null to (re)load the root level.

## Response `200`

Ok

- SouthExploreBrowseResult: Result of browsing (expanding) an entry within an explore session.
  - `entries` SouthConnectorExploreEntry[], required: The children of the browsed entry.
    - `id` string, required: Stable identifier of the entry, passed back to expand it. OPC UA node id (e.g. "ns=1;s=Temperature") or a folder-relative path.
    - `name` string, required: Human-readable label (OPC UA display name or file/folder name).
    - `metadata` RecordStringStringOrNumber, required: Construct a type with a set of properties K of type T
    - `metadataKinds` PartialRecordStringSouthConnectorExploreFieldKind: Make all properties in T optional
    - `hasChildren` boolean, required: Whether the entry can be expanded to reveal children in the explore tree.

## Changes

- **2026-10-21** `0df3f625a5c2`: 1 info
  - endpoint added
- **2026-10-20** `21b34a490fa3`: 1 breaking
  - api path removed without deprecation
- **2026-10-16** `d33279229ad1`: 1 info
  - added the optional property `entries/items/metadataKinds` to the response with the `200` status
- **2026-10-16** `6a8f54aa6963`: 1 info
  - endpoint added
- **2026-10-16** `eb4d55282f6a`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/optimistiksas/apis/oibus-api/changes/api/history/:historyId/explore/:sessionId/put.md)

---

[API](https://skmtc.dev/optimistiksas/apis/oibus-api.md) - [All operations](https://skmtc.dev/optimistiksas/apis/oibus-api/llms.txt) - [OpenAPI document](https://skmtc.dev/optimistiksas/apis/oibus-api/revisions/553df74bab85?raw)