v34

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

Check rollback readiness

Reports what a rollback of this stack can actually restore: the backed up compose file, env coverage (variable names only, never values), the known previous image tag, and an explicit disclosure that volume and bind-mounted data are not covered by file backups. Requires stack:read permission.

get/api/stacks/{stackName}/rollback-readiness

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

Rollback readiness report.

stackstring required
computedAtinteger required
overall'ready' | 'partial' | 'not_ready' required