db_deprecate
Flag a table or column as deprecated to prevent AI reliance, without deleting it. Reversible action keeps schema intact.
Instructions
Soft-retire a table or column annotation — flag it stale without deleting it.
Use when a table/column still exists but should no longer be relied on. The
deprecation flag is surfaced in db_get_schema so the AI is warned off it on
future calls. Reversible via undo=True. To remove an annotation entirely
(e.g. the column was dropped from the DB), use db_forget instead.
Args:
table: Table name, optionally schema-qualified (e.g. "users",
"public.users", "dbo.Orders", "mydb.orders").
connection: Connection name. Defaults to first defined.
column: Column to deprecate. Omit to deprecate the whole table.
reason: Why it's deprecated (e.g. "replaced by status_v2").
undo: Clear the deprecation flag instead of setting it.
Returns:
{table, connection, column, target, deprecated, reason}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| table | Yes | ||
| connection | No | ||
| column | No | ||
| reason | No | ||
| undo | No |