Put Retention
PUT/api/v1/system/retention
Store the override in the deploy repo, then apply it to every table that follows it.
The engine's own tables and every deployed source's table are brought to the new
effective default in this request, with ALTER TABLE ... MODIFY TTL (or
REMOVE TTL for 0). A table that declares its own TTL is left alone. A
ClickHouse failure answers 502 with the override ALREADY committed. Sending the
same value again applies it.
Request
Responses
- 200
- 401
- 403
- 422
- 502
- 503
- default
Successful Response
No valid session: the credentials are missing, invalid or expired, or the account behind them is disabled or blocked
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
Validation Error
reconcile_failed: the value is stored, and applying it to ClickHouse failed; sending the same value again applies it
not_configured: gitops is off, so there is nowhere to store the value
Problem details (RFC 9457)