Skip to main content
POST
Manual Self-Healing

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, malformed, unknown, revoked, inactive or expired key returns 401; a key without the permission, scope or plan an operation needs returns 403.

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.

Path Parameters

bucket_identifier
string
required

The unique identifier of the bucket.

batch_id
string
required

The unique identifier of the batch.

tier_num
integer
required

Zero-based tier number.

Required range: x >= 0

Body

application/json

Keys this body does not declare are ignored, and the response's warnings name them, until 2026-11-02; from 2026-11-02 they are refused with 422 extra_forbidden naming the accepted keys.

action
string
required

Self-healing action: 'kill_duplicates', 'detect_stuck', 'sync_status'.

Response

Successful Response

The response is of type Response Heal Tier V1 Buckets Bucket Identifier Batches Batch Id Tiers Tier Num Heal Post · object.