---
title: "Current runtime snapshot for an instance"
method: GET
path: "/v1/instances/{id}/runtime/snapshot"
tags: ["public", "runtime"]
---

# Current runtime snapshot for an instance

`GET /v1/instances/{id}/runtime/snapshot`

## Request

- Base URL: `https://api.vozora.io`
- URL: `https://api.vozora.io/v1/instances/{id}/runtime/snapshot`
- Auth: API key in header `Authorization`

Observed state, health and the latest value of each allow-listed metric. Carries no placement: the node, replica node and pool an instance runs on are cluster identity and never appear on a customer contract.

## Path parameters

- `id` string, required

## Query parameters

- `metrics` string

## Response `200`

OK

- RuntimePublicSnapshot
  - `health` RuntimePublicHealth
    - `freshness` 'fresh' | 'stale' | 'unavailable'
    - `observed_at` string
    - `reason` string
    - `source` 'demand' | 'convergence' | 'sampler'
  - `metrics` RuntimePublicMetricValue[]
    - `at` string
    - `key` 'cpu.usage' | 'memory.usage' | 'disk.read' | 'disk.write' | 'network.ingress' | 'network.egress'
    - `value` number
  - `service_id` string
  - `state` 'running' | 'stopped' | 'paused' | 'transitioning' | 'unknown'
  - `transition` RuntimePublicTransition
    - `action` string
    - `requested_at` string
    - `state` 'in_progress' | 'converged' | 'superseded' | 'timed_out'
    - `task_id` string
    - `updated_at` string

## Other responses

- `400`: bad_metric_key
- `401`: invalid or missing API key
- `403`: the key lacks runtime:read
- `404`: no such instance
- `429`: runtime_rate_limited
- `503`: runtime observation unavailable

---

[API](https://skmtc.dev/vozora/apis/vozora-api.md) · [All operations](https://skmtc.dev/vozora/apis/vozora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vozora/apis/vozora-api/revisions/56f15734fc5a?raw)