API Reference

Refresh descriptions

Re-run only the describe pass over an already-ingested project.

POST/instances/{project}/describeadmin, user

Re-run only the describe pass — no cgr, no re-embedding of unchanged chunk_text — as a background job. Useful when switching descriptor models or filling gaps without a full re-ingest.

Only chunks whose rebuilt chunk_text is byte-identical to what's stored are described (anti-drift guard). Entities whose source changed on disk are counted stale_source and skipped.

Path parameters

projectstringrequired

The project_name of an already-ingested repo.

Body

forceboolean

Bypass the description cache and regenerate every eligible entity. Default false.

Request

cURL

bash

curl -X POST localhost:8000/instances/your-repo/describe \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"force": false}'

Responses

200Job accepted and queued

json

{ "job_id": "...", "status": "queued" }

404Project has no chunks — never ingested

json

{ "detail": "project 'your-repo' has no chunks — ingest it first with POST /instances/pipeline" }

409Graph JSON missing, or a job is already running

json

{ "detail": "another job is running for project 'your-repo'" }

← PreviousStart a graph-only run Next →List ingestion jobs