v2

latestOpenAPI 3.1.02026-08-05313314398.1 KB
databases

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