Update a catalog fact

Idempotently sets a semantic metadata fact by name: creates it when the name is new, updates it when it already exists. An inferred write cannot overwrite an existing confirmed fact.

put/catalogs/{catalog}/facts/{name}

Path parameters

catalogstring required

The name of the catalog.

namestring required

The name of the fact.

Query parameters

environmentstring

Environment containing the catalog definition to update. This operation does not fall back to default.

Request body

$schemastring uri

A URL to the JSON Schema for this object.

bodystring

Optional structured payload (SQL, unit, enum values) as a JSON string.

confidence'confirmed' | 'heuristic' | 'inferred' required

How trustworthy the fact is.

objectstring

Descriptive path to what the fact is about, e.g. "bronze.runs.deleted_at". Empty for catalog-scoped facts.

scope'catalog' | 'namespace' | 'table' | 'column' | 'metric' required

What kind of object the fact is about.

sourcestring

Where the fact came from (agent id, user, ...).

statementstring required

The human-readable meaning of the fact.

Example request

{
  "$schema": "https://api.tower.dev/v1/schemas/UpdateCatalogFactBody.json"
}

Response

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://api.tower.dev/v1/schemas/UpdateCatalogFactResponse.json"
}

Changes

No recorded changes to this endpoint across all 5 revisions of this API.