Skip to content
getgeolens.com
GeoLens Docs

Trigger Backfill

POST
/admin/backfill-embeddings/
 
curl --request POST \
  --url 'https://example.com/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 ”

200

Section titled “200 ”

Successful Response

Media type application/json
BackfillResponse
object
created
required
Created

Number of new embeddings created.

integer
errors
required
Errors

Number of records that failed during embedding generation.

integer
processed
required
Processed

Number of records processed in this backfill batch.

integer
skipped
required
Skipped

Number of records skipped because an embedding already existed.

integer
Example generated
{
  "created": 1,
  "errors": 1,
  "processed": 1,
  "skipped": 1
}

400

Section titled “400 ”

Bad request — invalid query parameters or payload

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "type": "about:blank"
}

401

Section titled “401 ”

Unauthorized — missing or invalid credentials

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "type": "about:blank"
}

403

Section titled “403 ”

Forbidden — caller lacks access to this resource

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "type": "about:blank"
}

404

Section titled “404 ”

Not found

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "type": "about:blank"
}

422

Section titled “422 ”

Validation error

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "type": "about:blank"
}

500

Section titled “500 ”

Internal server error

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "type": "about:blank"
}