Overlays
Confirm Overlay
Confirm an overlay, materializing it onto the served spec.
Requires overlays:confirm: confirming rewrites the API's served spec (it re-ingests the base spec with the overlay applied and promotes the result to the current revision), so it is an operator action, not a contributor one (contributors submit overlays with apis:write; an operator reviews and confirms). This is a purpose-scoped downgrade from the former org:admin gate — narrow enough that an owner can grant it to a trusted operator without handing over full admin power. org:admin still satisfies it (it implies overlays:confirm), and the scope is deliberately excluded from an agent's self-service grantable set so a low-privilege agent cannot escalate into it.
post/apis/{vendor}/{name}/{version}/overlays/{overlay_id}:confirm
Path parameters
vendorstring required
namestring required
versionstring required
overlay_idstring required
Request body
Response
Successful Response
{"stackTrail":"paths:/apis/{vendor}/{name}/{version}/overlays/{overlay_id}%3Aconfirm:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}