---
title: "Get Volume Snapshot Timeline"
method: POST
path: "/telemetry/volumes/{volume_id}/snapshot_timeline"
tags: ["Ops IQ"]
---

# Get Volume Snapshot Timeline

`POST /telemetry/volumes/{volume_id}/snapshot_timeline`

## Request

- Base URL: `https://am1.portal.api.nasuni.com`
- URL: `https://am1.portal.api.nasuni.com/telemetry/volumes/{volume_id}/snapshot_timeline`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nasuni/apis/portal-api/docs/telemetry/volumes/:volume_id/snapshot_timeline/post.ts> (a function with typed inputs; its response is checked against the schema)

Get push timeline telemetry for a volume.

## Path parameters

- `volume_id` string, required

## Request body

- VolumeTelemetryRequestDto: Request DTO for volume telemetry data (volume_id is in URL path).
  - `period` string, required: Time period in ISO 8601 format. Examples: 'PT1H' (last 1 hour), 'P1D' (last 1 day), '2025-01-01T00:00:00Z/2025-01-02T00:00:00Z' (specific interval), or millisecond timestamps '1730390400000/1730476800000'. Minimum range: 6 minutes.
  - `serial_numbers` string[], required: Appliance serial numbers to filter data - ensures stability across DR events
  - `chart_width` integer, nullable: Chart width in pixels (100-5200) - affects sampling density
  - `smart_sampling` boolean, nullable: Enable optimized dataset for trend analysis with faster load times

## Response `200`

Successful Response

- VolumeTelemetryPushTimelineDto: Volume push timeline with data and metadata events.
  - `metadata` object: Telemetry metadata (help text, metric definitions)
  - `data_events` VolumeTelemetryPushTimelineDataEventDto[], required: Data snapshot phase (P1) events - multiple appliances can protect concurrently
    - `phase` 'data_snapshot', required: Event type: 1 indicates data snapshot phase (P1)
    - `appliance` string, required: Appliance name/description
    - `serial_number` string, required: Appliance serial number
    - `start_time` integer, required: Timestamp in milliseconds when data snapshot phase started
    - `end_time` integer, required: Timestamp in milliseconds when data snapshot phase ended
  - `metadata_events` VolumeTelemetryPushTimelineMetadataEventDto[], required: Metadata snapshot phase (P2) events - metadata snapshots are serialized
    - `phase` 'metadata_snapshot' | 'metadata_snapshot_failed', required: Event type: 2 for successful metadata snapshot (P2), -2 for failed metadata snapshot
    - `appliance` string, required: Appliance name/description
    - `serial_number` string, required: Appliance serial number
    - `start_time` integer, required: Timestamp in milliseconds when metadata snapshot phase started
    - `end_time` integer, required: Timestamp in milliseconds when metadata snapshot phase ended
    - `volume_version` integer, required: Sequential snapshot version number
  - `appliance_count` integer, required: Total number of appliances involved in snapshots
  - `min_time` integer, required: Earliest timestamp in milliseconds across all events
  - `max_time` integer, required: Latest timestamp in milliseconds across all events

## Other responses

- `401`: Not authenticated
- `403`: Insufficient permissions or license
- `404`: Resource not found
- `408`: Request timeout
- `413`: Payload too large
- `422`: Invalid input data
- `429`: Too many requests (rate limit exceeded)
- `500`: Internal server error

---

[API](https://skmtc.dev/nasuni/apis/portal-api.md) - [All operations](https://skmtc.dev/nasuni/apis/portal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nasuni/apis/portal-api/revisions/2a505bec6d14?raw)