Skip to content
You're viewing documentation for v2026.11.7-beta. It may be out of date.Go to latest
TimescaleDB Enterprise
Esc
↑↓navigate↵open⌘Jpreview

Discard pending settings

Sets each override that waits for its apply back to its applied value, removes the overrides that no workflow applied, and sets the HBA rules back to the applied rules (ADR D7). A failed apply can leave new values in the DCS, so first the console writes the applied values of the PostgreSQL overrides back into the DCS; when Patroni does not answer, it answers 502 and discards nothing. It answers 409 when settings_version is old or while a workflow runs on the service. With nothing to discard, it changes nothing.

POST/api/v1/database-services/{id}/settings/discard
Authorization
tse_sessionAPI key · cookierequired
Path parameters
idstringrequired
Request body
requiredapplication/json
settings_versioninteger<int64>required

The version that the user saw.

Responses
200

OK

discardedstring[]required

The names of the overrides that the discard set back.

hbabooleanrequired

The discard set the HBA rules back to the applied rules.

settings_versioninteger<int64>required
default

Error

codestring

Stable code of the refusal, when the route has codes

detailsstring[]

Additional detail, e.g. per-field validation failures

errorstringrequired

Human-readable error message

Request
curl -X POST 'https://console.example.com/api/v1/database-services/string/settings/discard' \
  -H 'Cookie: tse_session=YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "settings_version": 0
}'
Response
{
  "discarded": [
    "string"
  ],
  "hba": true,
  "settings_version": 0
}