Skip to main content
GET
Aggregated metric values over a window (max 30 days)

Authorizations

Authorization
string
header
required

An organization API key (obs_pub_…) sent as Authorization: Bearer <key>. Each key carries scopes; an endpoint lists the scope it needs. read:change_events is reserved: keys can carry it, but no endpoint needs it yet.

Scopes

read:metrics

Path Parameters

id
string<uuid>
required

Metric id.

Query Parameters

from
string<date-time>
required

Window start, ISO 8601.

to
string<date-time>

Window end, ISO 8601. Defaults to now. Must be after from and at most 30 days later.

resolution
enum<string>
default:1m

Bucket width.

Available options:
1m,
5m,
15m,
1h,
1d

Response

ok

resolution
enum<string>
required
Available options:
1m,
5m,
15m,
1h,
1d
from
string<date-time>
required
to
string<date-time>
required
items
object[]
required