STstudio-saelix
Stacks

Compute image update preview (read-only)

Changed on

Computes the current registry update preview for the stack without mutating persisted scanner state. Use POST when the client should reconcile sticky update indicators after an authoritative-negative result. Requires stack:read permission.

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

Request

  • Base URL
    https://localhost:1852
  • URL
    https://localhost:1852/api/stacks/{stackName}/update-preview
  • Auth
    HTTP bearer

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.

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

Changes