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

# Runtime capabilities for an instance

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

## Request

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

Which metrics this server reports, at what resolutions and over what history, and whether logs are available. Ask this first: the metric keys here are the only ones /metrics and /snapshot accept, and requesting another is a 400.

## Path parameters

- `id` string, required

## Response `200`

OK

- RuntimePublicCapabilities
  - `history_windows_seconds` integer[]
  - `logs` RuntimeLogsCapability
    - `available` boolean
    - `max_limit` integer
  - `metrics` RuntimeMetricDescriptor[]
    - `key` 'cpu.usage' | 'memory.usage' | 'disk.read' | 'disk.write' | 'network.ingress' | 'network.egress'
    - `kind` 'gauge' | 'counter' | 'rate'
    - `unit` string: "percent" | "bytes" | "bytes_per_second"
  - `refresh_hint_ms` integer
  - `version` integer

## Other responses

- `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)