Set Overlay Var
PUT/api/v1/backing-services/overlays/:name/vars/:path
Set an infra overlay value.
409 managed_by_provider, before any other check, when DFE does not run the service and the value is one of its read_only paths. helmvars:override does not lift it. 403 with the policy that blocked it when the var is protected - the storage model, the data-layer modes and the disk size are decided at deploy, and moving one on a live deployment is a data migration. 400 when the value would lower a declared node or broker count, or leave it undeclared (a parent map that omits it), which loses data rather than capacity. helmvars:override does not lift it.
Request
Responses
- 200
- 401
- 403
- 409
- 422
- 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
managed_by_provider: DFE does not run the service, so nothing in the deployment reads this value; context names who sizes it and set_in where. Also conflict (a stale If-Match) and review_required (production+team).
Validation Error
Problem details (RFC 9457)