You can open a Vantage Room on a specific time range or capsule by adding query parameters to the URL of the room's default view. This is useful when an external system, such as a notification or a monitoring application, knows which event it wants to show and needs to link users straight to it in Vantage. Any user following these links needs Read access to the room.
How it Works
A Vantage Room URL looks like:
https://<server>/workbook/<roomId>/worksheet/<viewId>
Copy the URL of the room's default view from your browser. Add query parameters after ?, separating each parameter with &.
The parameters are read when the room loads and apply to the Evidence table in that view. The date/time parameters use the same formats described in the Workbench page.
These parameters affect only the session that opened the link. They do not create a workstep or change the saved view.
Query Parameters
Date and Time
investigateStartTime, investigateEndTime
Set the investigate range, which is the time window the Evidence table fetches capsules for.
displayStartTime, displayEndTime
Set the display range, which is the range shown in trends such as QuickTrend.
Each value can use an ISO-8601 timestamp or a relative-to-now value:
-
ISO-8601:
2026-09-01T00:00:00-07:00 -
Relative:
*for now,*-7dfor 7 days ago, or*-2h
If you provide only the start of a pair, the end is now. If you provide only the end, the start is now. A lone end must be in the future, and a lone start must be in the past.
A pair is ignored if either value cannot be parsed or if the start is after the end. The investigate and display pairs are independent, so one can apply while the other is ignored.
Applying either pair turns off the room's auto-update (live) mode while the link is open, so the range stays fixed.
Example: investigateStartTime=2026-09-01T00:00:00-07:00&investigateEndTime=2026-09-04T00:00:00-07:00
Example: displayStartTime=*-7d&displayEndTime=*
Capsule Selection
capsuleId
Open the room on one specific capsule, or event. The value is the Evidence table's Capsule ID: the condition's item ID, a colon, and the capsule's ID (datum ID). The condition ID is not case sensitive; the capsule ID must match exactly.
Example: capsuleId=1318D1AE-86AA-4C09-A19C-BBE1586B46D2:1788437040000000000
The trend form with an underscore is also accepted:
Example: capsuleId=1318D1AE-86AA-4C09-A19C-BBE1586B46D2_1788437040000000000
You can get these values from the Capsule ID column in the Evidence table. The column is hidden by default; enable it from the table's Columns menu. You can also get them programmatically: the condition's ID, plus the capsule id returned by the Seeq REST API (GET /conditions/{id}/capsules) or SPy.
When the room opens with a valid capsuleId, the Evidence table shows only that capsule, expands any groups on the path to it, shows the Condition ID and Capsule ID columns at the right of the table so the active filters are visible, and selects the row so the Context panel shows its details and history.
The capsule must be inside the room's investigate range or it will not be fetched. Pair capsuleId with investigate range parameters that bracket the capsule.
If capsuleId is malformed, the parameter is ignored and the room opens normally. It can be combined with a link from the Share button (workstepId); if both specify a selection, capsuleId wins. To return to the full table, clear the table filters with the clear-filters button in the Evidence table toolbar.
Examples
Example 1: Fixed investigate range.
Example 2: Relative investigate and display ranges.
Example 3: Open on one event.