POST /api/entities/backfill
Run entity extraction over memories that don't have an entity-linked metadata yet. Useful after upgrading from a Mnueron version that didn't yet support P2 entities, or after bulk-importing legacy memories.
⚠️ Paid plan required. Uses the operator's Anthropic/OpenAI key on the backend — BYOK is not honored on this endpoint.
curl -X POST https://www.mnueron.com/api/entities/backfill \
-H "Authorization: Bearer $MNUERON_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"namespace": "work",
"since": 1730000000000,
"limit": 100,
"dry_run": false
}'
Body
| Field | Type | Default | Notes |
|---|---|---|---|
namespace | string | — | Restrict the backfill window |
since / until | int | — | Epoch ms |
limit | int | 100 | 1..1000 memories per call |
force | bool | false | Re-extract even on memories that already have entities |
dry_run | bool | false | Score the extraction without writing |
Response
{
"processed": 47,
"extracted": 39,
"resolved": 35,
"skipped": 8,
"errors": 0,
"memories": [
{ "id": "01HQ…", "entities_added": 3, "entities_reused": 2 }
]
}
402 when called on a free org (upgrade_required: true in the body).