Skip to main content
GET
Get Namespace Errors

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:72

Hours of history to analyze

Required range: 1 <= x <= 720

Response

Successful Response

Per-resource error counts across a namespace in one response.

Batches what used to be one /analytics/{collections,clusters}/{id}/failures call per resource (the Studio Monitoring "Errors & Health" N+1) into a single namespace-scoped query pair. Only resources with at least one error/failure in the window are returned, so an empty collections/clusters list means that resource type is healthy for the window.

namespace_id
string
required

Namespace ID analyzed

hours
integer
required

Hours of history analyzed

total_errors
integer
required

Total errors + failures across all resources in the window

collections
ResourceErrorCount · object[]

Collections with extraction errors (ClickHouse extraction_events)

clusters
ResourceErrorCount · object[]

Clusters with execution failures (Mongo clustering_results)