Apply a full config from the request body, atomically (live until next reload/restart; health preserved by lane identity)

Changed on
post/api/v1/admin/config/apply

Request

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

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.

Request body

configobject required

A config.yaml deploy block, as JSON. The accepted shape is the config file's own, documented in the configuration reference; it is not restated here because several of its types parse a wire shape that does not match their field layout.

providersobject

A providers.yaml document, as JSON. The accepted shape is the config file's own, documented in the configuration reference; it is not restated here because several of its types parse a wire shape that does not match their field layout.

Response

{applied, config_version, note}

appliedboolean required
config_versioninteger required
notestring required

Changes

  • 857732ef7bbeRevision changes
    • breaking

      added required request body

    • info

      api operation id PostConfigApply was added

    • info

      added the non-success response with the status