Trigger Backfill

POST

/admin/backfill-embeddings/

curl --request POST \
  --url 'https://example.com/api/admin/backfill-embeddings/?force=false' \
  --header 'Authorization: Bearer <token>'

Trigger 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

• OAuth2PasswordBearer

Parameters

Query Parameters

force

Force

boolean

Responses

200

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
}

422

Validation Error

Media type application/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

input

Input

ctx

Context

object

Example ^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}