Skip to main content
GET
Get Namespace Buckets Health

Authorizations

Authorization
string
header
required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing header returns 403; an invalid or revoked key returns 401.

X-Namespace
string
header
required

Namespace id (ns_...), not the namespace name. This scopes the request rather than authenticating it, and it is required on every operation marked x-mixpeek-namespace-scoped.

Query Parameters

hours
integer
default:24

Hours of history

Required range: 1 <= x <= 720

Response

Successful Response

Batch health for all buckets in the namespace (single request).

Replaces the per-bucket GET /{bucket_id}/health fan-out on monitoring surfaces (browser N+1 that scaled with bucket count). Only buckets with events in the window appear — a bucket absent from buckets had no errors and no sync activity and should render as healthy.

time_range
TimeRange · object
required

Query time range

buckets
BucketHealthResponse · object[]
required

Per-bucket health, one entry per bucket with events in the window. Absent bucket == healthy/no activity.