Skip to content

Check admin search integrity

POST
/api/v1/admin/search/integrity/check
curl --request POST \
--url https://example.com/api/v1/admin/search/integrity/check \
--header 'Authorization: Bearer <token>'

Checks the admin search integrity. It requires a signed-in User with the admin scope and the admin or owner Role. It can return 401 if the session is missing or expired, 403 if access is denied and 503 if the service is temporarily unavailable. Route: /api/v1/admin/search/integrity/check. Inputs: . A recent account assertion is required. Do not automatically replay this operation after an uncertain result.

Media typeapplication/json

Latest full comparison between the filesystem and the derived search Index.

object
checked_at_unix_ms

Unix time in milliseconds for the last completed check.

integer | null format: int64
checked_items
required

Number of searchable filesystem paths checked, including folders.

integer format: int64
healthy
required

True when the post-repair Index matches the filesystem and manifest.

boolean
last_error

The latest scan error, if a check did not complete.

string | null
manifest_mismatches
required

Filesystem paths whose SQLite manifest row needed an update.

integer format: int64
missing_items
required

Documents missing from the Index before repair.

integer format: int64
repaired_items
required

Source paths changed by the repair.

integer format: int64
running
required

True while the actor is scanning and repairing the Index.

boolean
stale_items
required

Documents absent from the filesystem or duplicated in the Index.

integer format: int64
Examplegenerated
{
"checked_at_unix_ms": 1,
"checked_items": 1,
"healthy": true,
"last_error": "example",
"manifest_mismatches": 1,
"missing_items": 1,
"repaired_items": 1,
"running": true,
"stale_items": 1
}