STstudio-saelix
Observation

Stack update and rollback readiness for an AI observer

Changed on

Returns one stack's canonical update and rollback readiness verdicts, projected for an Observe Only token. Each verdict slot carries the verdict, the id of its strongest reason, and when it was computed; the free-text description behind the verdict is withheld. unavailableReason is set to summary_truncated or domain_error only when both slots are null. This is one of the five paths an Observe Only token may reach. Requires stack:read permission for the named stack.

get/api/stacks/{stackName}/observation/readiness

Request

  • Base URL
    https://localhost:1852
  • URL
    https://localhost:1852/api/stacks/{stackName}/observation/readiness
  • 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

Readiness verdicts wrapped in the observation envelope.

schemaVersion1 required
generatedAtinteger required

Epoch ms of the evidence behind the answer.

Changes