Patch Defaults

PATCH 
/api/v1/system/defaults

Store the named defaults. Only ttl_days is applied to live tables.

Omitted fields are left alone. null clears that override. Common-header type, version and engine are what a source inherits the next time it is deployed. This request does not rewrite them onto live tables. A patch that names ttl_days stores it and then runs the same reconcile as PUT /retention.

Request

Responses

200

Successful Response

401

No valid session: the credentials are missing, invalid or expired, or the account behind them is disabled or blocked

403

Refused: the session lacks the action this route checks, or its account must replace an issued password first. A SCIM route answers a refused action in the RFC 7644 error envelope

422

validation_error: a named value cannot be stored

502

reconcile_failed: ttl_days is stored, and applying it to ClickHouse failed; sending the same value again applies it

503

not_configured: gitops is off, so there is nowhere to store the value

default

Problem details (RFC 9457)