Trigger Backfill
POST
/admin/backfill-embeddings/
const url = 'https://example.com/api/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/api/admin/backfill-embeddings/?force=false' \ --header 'Authorization: Bearer <token>'Trigger 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).
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Query Parameters
Section titled “Query Parameters ” force
Force
boolean
Responses
Section titled “ Responses ”Successful Response
Media type application/json
BackfillResponse
object
processed
required
Processed
Number of records processed in this backfill batch.
integer
created
required
Created
Number of new embeddings created.
integer
skipped
required
Skipped
Number of records skipped because an embedding already existed.
integer
errors
required
Errors
Number of records that failed during embedding generation.
integer
Example generated
{ "processed": 1, "created": 1, "skipped": 1, "errors": 1}Bad request — invalid query parameters or payload
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Unauthorized — missing or invalid credentials
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Forbidden — caller lacks access to this resource
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Not found
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Validation error
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Internal server error
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}