Skip to content
Embabel Worlds

The acting user's fills, newest first, with key coverage, tick and live-call progress

GET
/api/v1/admin/kg/fills
curl --request GET \
  --url http://localhost:11044/api/v1/admin/kg/fills \
  --header 'X-Embabel-Api-Key: <X-Embabel-Api-Key>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
username
string

Username to act as; when it resolves to a user it is used in preference to the authenticated principal. Omitted or blank, the authenticated principal acts; 401 when neither resolves

Responses

Section titled “Responses”

200

Section titled “200”

The acting user’s fills

Media typeapplication/json
Array<object>

A fill: a slow, resumable materialization of one query, re-run a budgeted chunk per tick until a pass buys nothing. What /admin/kg/fills starts and lists.

object
budgetPerTick
required

Units of paid work one tick may buy — a producer fetch group or a group of an inline model judgement, not HTTP requests or tokens. Clamped to 1–500; defaults to 60.

integer format: int64
cypher
required

The Cypher every tick re-runs, as it was submitted.

string
id
required

The fill’s id, fill_ plus 12 hex characters — what DELETE /admin/kg/fills/{id} takes.

string
label
required

A display name for the fill. Empty when none was given.

string
progress
required

How far the fill has got, as of its most recent tick.

object
coverage
required

Keys the producer caches answer, of the total the last pass enumerated. keysTotal is null where the query has no denominator; never derive a fraction then.

object
fractionResolved
number format: double
keysResolved
required

Distinct key units, one per producer, key and period, answered in the execution from a cache tier or a successful fetch

integer format: int64
keysTotal

Distinct key units the execution demanded; null when the sweep has no denominator (totality UNKNOWN), which never means zero

integer format: int64
totality
required
string
Allowed values: KNOWN UNKNOWN
createdAt
required

Epoch milliseconds at which the fill was started.

integer format: int64
lastError

Why the most recent tick failed or was refused. Null when it ran clean. An error leaves the fill RUNNING.

string
lastTickAt

Epoch milliseconds of the most recent tick, refused ones included. Null before the first.

integer format: int64
liveCallsLastTick
required

Paid calls in the most recent tick alone, counted as liveCallsTotal counts them.

integer format: int64
liveCallsTotal
required

Paid calls across every tick: producer fetches, in-query model calls and semantic searches.

integer format: int64
state
required

RUNNING, DONE (a full pass needed no paid work) or CANCELLED.

string
ticks
required

Chunks run so far. A chunk refused before it ran — a halt, a ceiling — does not count.

integer format: int64
trend
required
string
Allowed values: UNKNOWN CONVERGING NOT_CONVERGING
routine

The routine the fill runs as, whose agent governs every chunk. Null for a fill an operator started outside any routine run.

string
userId
required

The id of the user the fill belongs to and runs as.

string
warning

Why this fill will keep polling rather than reach DONE — its producers’ records do not outlive a sweep. Decided at start. Null when it can converge, or when the query could not be planned to say.

string

Example 

[
  {
    "progress": {
      "coverage": {
        "totality": "KNOWN"
      },
      "trend": "UNKNOWN"
    }
  }
]

401

Section titled “401”

No authenticated principal and no resolvable username

Media typeapplication/json

A refusal carrying only a human-readable reason.

object
error
required

What went wrong, in the terms the caller can act on.

string

Example generated

{
  "error": "example"
}