Force-run one embedding refresh sweep

View as Markdown
Runs one embedding maintenance sweep for the requested refresh mode.

Authentication

AuthorizationBearer

User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key

OR
X-API-Keystring

Admin API key for system-to-system write operations

Query parameters

contentSourceTypeenumOptional
Required unified content partition to act on, for example entity, person, or newsArticle.
kindenumRequired

Refresh sweep kind: stale-similarity, stale-embedding, or owner-reconcile

Allowed values:
limitintegerOptionalDefaults to 10

Maximum items to enqueue for this sweep (1-500, clamped)

Response

OK
enqueuedinteger
Number of source ids accepted into the refresh lane
kindstring

Refresh kind: fresh, stale-similarity, stale-embedding, owner-reconcile

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error