v34

latestOpenAPI 3.1.0AGPL-3.0-onlyraw.githubusercontent.com2026-08-018932140.9 KB
Stacks

Compute update preview and reconcile sticky state

Computes the same preview as GET. When every image reports check_status: ok and has_update is false (mixed ok + not_checkable does not clear), clears sticky confirmed update rows for the stack and sets reconciled: true. Requires stack:read permission.

post/api/stacks/{stackName}/update-preview

Path parameters

stackNamestring required
Example:my-stack

Stack directory name. Must match ^[a-zA-Z0-9_-]+$ (alphanumeric characters, hyphens, and underscores only). Returns 400 Invalid stack name if the name contains path separators, dots, spaces, or other special characters.

Headers

x-node-idinteger
Example:1

Target a specific node by ID. If omitted, the default node is used. Can also be passed as ?nodeId= query parameter.

Response

Update preview, with reconcile outcome.

stack_namestring required
build_servicesstring[] required
rollback_targetstring nullable required
changelogstring nullable required
reconciledboolean required

True when sticky update rows were cleared after an authoritative-negative preview.