Trigger Backfill
const url = 'https://example.com/admin/backfill-embeddings/?force=false';const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url 'https://example.com/admin/backfill-embeddings/?force=false' \ --header 'Authorization: Bearer <token>'Queue semantic-search embedding generation for records (admin only).
Pass ?force=true to delete all existing embeddings and regenerate from scratch (required after changing the embedding model or dimensions).
The run happens on the job queue because a full regeneration can exceed
request timeouts. This endpoint returns the job id; poll
GET /jobs/{job_id} for the outcome.
Authorizations
Section titled “ Authorizations ”Parameters
Section titled “ Parameters ”Query Parameters
Section titled “ Query Parameters ”Responses
Section titled “ Responses ”Successful Response
Acknowledgement that a backfill run was queued.
The response carries no counts because the work runs asynchronously. Poll
GET /jobs/{job_id} for status.
object
Identifier of the queued backfill job; poll /jobs/{job_id}.
Job status at enqueue time (‘pending’).
Example generated
{ "job_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "status": "example"}Bad request — invalid query parameters or payload
Unauthorized — missing or invalid credentials
Forbidden — caller lacks access to this resource
Not found
Conflict — resource state prevents the operation
Validation error
Too many requests — retry after the advertised interval
Headers
Section titled “ Headers ”Seconds until the request may be retried
Internal server error
Service unavailable — the background job queue could not be reached