DISCARD a section's overlay mutations and revert it to base config.yaml (section ∈ groups|hooks|root|plugin_versions). Per-section reset: the OTHER sections' overlay survives. A NEW config version; an already-empty section is an idempotent no-op (changed:false)

Changed on
delete/api/v1/admin/overlay/{section}

Request

  • The document declares no server URL.
  • Auth: one of:
    • API key in header x-admin-token
    • HTTP bearer

Path parameters

section'groups' | 'hooks' | 'root' | 'plugin_versions' required

Headers

If-Matchstring

Optimistic concurrency: the resource's ETag from a prior read (or the ETag returned by the previous mutation). Stale = 409 version_conflict (re-read and retry), nothing changes; absent or * = unconditional.

Response

{reset, config_version, changed}: changed:false when the section had no overlay state

changedboolean required

true when the reset discarded overlay mutations; false for an already-empty section.

config_versioninteger required
resetstring required

The section that was reset (groups | hooks | root | plugin_versions).

Changes