schema_confirm_mapping
Prevent incorrect data writes by previewing a table's schema mapping with sample resolved values, then confirm to activate write tools.
Instructions
Confirm a table's schema mapping, unlocking write tools for it (knowledge_ingest,
kb_journal, kb_promote today). overrides lets you correct individual
canonical-field -> real-column assignments before confirming, e.g.
{"source": "origin_ref"} or {"tags": null} to explicitly mark a field
unmapped. Gated separately from knowledge_write — confirming a mapping
is a more consequential act than a single write.
preview=True: dry-run — return the proposed mapping AND a rendered sample
row (what each canonical field actually resolves to) WITHOUT confirming or
writing. Review the sample first: a column that name-matches but holds the
wrong data — e.g. a content column that is really a provenance blob, with
the real text in title/summary — reveals itself in the sample where a
name match cannot. preview=False (default): confirm, and include the sample
in the response so the confirmation is never blind.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| table | Yes | ||
| app_id | Yes | ||
| preview | No | ||
| overrides | No |