Skip to main content
GET
Context Status

Response

Successful Response

loaded
boolean
required

Whether your knowledge context is currently loaded and ready to serve queries. When false, the first query pays a cold-start cost.

up_to_date
boolean
required

True iff loaded_snapshot == latest_snapshot (and both are present). This is snapshot parity only: records ingested after the latest snapshot was built are not in it. Use includes_latest_ingest to know whether answers cover everything ingested so far.

latest_snapshot
string | null

Identifier of the most recent snapshot in storage. None when no refresh has succeeded yet for this workspace.

latest_built_at
string | null

ISO-8601 last-modified timestamp of the latest snapshot.

loaded_snapshot
string | null

Snapshot the loaded context is serving. May lag behind latest_snapshot if a newer refresh finished after the context was loaded.

evidence_watermark
string | null

Ingestion watermark of the loaded snapshot: when its newest record was ingested, not when that record occurred; present only when loaded is true.

includes_latest_ingest
boolean | null

True when the loaded snapshot includes every record ingested so far (evidence_watermark has reached last_ingested_at). False while recently ingested records are still being processed into a new snapshot: answers and queries may not reflect them yet. Omitted when unknown (nothing loaded, or nothing ingested).

evidence_types
Evidence Types · object | null

Count of your current records by type. Omitted when the counts are temporarily unavailable — absent means unknown, not zero.

earliest_evidence_at
string | null

Timestamp of your oldest record (when it occurred, not when it was ingested).

latest_evidence_at
string | null

Timestamp of your newest record (when it occurred, not when it was ingested).

first_ingested_at
string | null

When your first record was ingested (not when it occurred).

last_ingested_at
string | null

When your most recent record was ingested (not when it occurred).

latest_entity_at
string | null

When any entity in your knowledge context last changed, independent of snapshots.

connectors
Connectors · object[] | null

Per-connector coverage of latest_snapshot. Omitted when no snapshot exists yet.

augmentations
string[] | null

Augmentations whose layer is built into latest_snapshot (see GET /v1/knowledge/settings for your settings). Omitted when no snapshot exists yet — absent means unknown, not none.