Skip to main content
POST
List incident metadata distributions
For how to investigate error incidents with this endpoint, see Querying traces.

Authorizations

Authorization
string
header
required

Authorization: Bearer <token>

Body

application/json

Query for the metadata distribution list.

site_id
string
required

Site to fetch metadata for.

incident_digests
string[]
required

Incident digests to include.

from
string<date-time>
required

Start of the time range (inclusive).

group_by
enum<string>
required

Which dimension to group by (KEY or VALUE).

Available options:
KEY,
VALUE
to
string<date-time> | null

End of the time range (inclusive). Defaults to now.

metadata_key
string | null

The metadata key to filter values by. Required when group_by is VALUE; ignored in KEY mode.

limit
integer<int32> | null

Maximum rows to return, clamped to 1–1000. Defaults to 10 in VALUE mode; in KEY mode absent means no limit.

Response

A bare array: key rows in KEY mode, value rows in VALUE mode.

A single metadata key row (KEY mode).

key
string | null
required

The metadata key (e.g. hostname).

total
integer<int64> | null
required

Total occurrences across all values.

unique
integer<int64> | null
required

Number of distinct values.