v2
latestOpenAPI 3.1.02026-08-05313314398.1 KBdatabases
Refresh Database
Refresh this Database. Cascade to children fires automatically.
force_full=true requests a full rebuild (ignore incremental watermarks). Honored for project-owned datasets, where it is persisted on the dispatched Run; integration-owned (crawler) refreshes always re-poll the source and ignore the flag.
- Integration-owned (data lake table): signal the crawler workflow to poll that integration. _update_database_stats then fires trigger_dependent_steps for the children once the poll completes.
- Project-owned: dispatch a Run rooted at the producing data_sink, which walks the project's own ancestor closure (parents are NOT re-run — the data_read step uses upstream data as it stands today). The run's terminal phase fires trigger_dependent_steps for the children.
- File-backed / unbacked: cannot be refreshed (400).
post/api/v1/databases/{database_id}/refresh
Path parameters
database_idstring uuid required
Query parameters
force_fullboolean
Response
Successful Response
object required