Skip to content
Folio

folio status

folio status <SHEET> [TARGET]

TARGET is an optional positional argument naming a single derived field. Omit it to include every x-derived field.

Returns an object keyed by derived field, with per-source counts and the most recent provenance timestamp.

Output

{
  "country_code": {
    "total_records": 7,
    "with_provenance": 7,
    "ai_count": 0,
    "import_count": 0,
    "human_override_count": 0,
    "last_at": "2026-05-10T10:16:35Z",
    "last_actor": "agent:demo"
  },
  "industry_tag": {
    "total_records": 7,
    "with_provenance": 5,
    "ai_count": 5,
    "human_override_count": 1,
    "last_at": "2026-05-10T11:02:00Z",
    "last_actor": "agent:enrichment"
  }
}
FieldMeaning
total_recordsCount of records in the sheet.
with_provenanceRecords that have at least one provenance entry for this field.
<source>_countRecords whose latest provenance for this field has that source.
last_at / last_actorThe most recent provenance entry across the whole field.

Filtering

Terminal window
folio status ./customers country_code

Status takes one field at a time. To see every derived field, omit the positional target:

Terminal window
folio status ./customers

What it powers

The Viewer’s dashboard reads this endpoint to render per-target cards (Viewer overview). MCP exposes the same as the materialization_status tool.

See also