Re-embed stale chunks

POST

/api/embed/admin/reembed

Maintainer:Not configured

OperationId:admin_reembed

Enqueues embedding jobs for chunks whose vector is missing or came from a model the server no longer embeds with, scoped to one resource, one context, or everything. dry_run reports what is stale without enqueuing. Bounded by limit per call and safe to repeat. Requires a system admin.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

What is stale in scope, and the resources enqueued (none on dry_run)

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/embed/admin/reembed' \
--header 'X-Temper-Surface;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "all": true,
    "context_id": "f31d7249-b7b1-4729-b3a4-ec0ba07b4686",
    "dry_run": true,
    "limit": 0,
    "resource_id": "4d5215ed-38bb-48ed-879a-fdb9ca58522f"
}'

Response Example

200 - Example 1

{
    "enqueued": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "stale_chunks": 0,
    "stale_resources": 0
}

Modified at 2026-10-06 12:32:37

Survey a resource erasure

Rebind a machine client to a new client ID