STstudio-saelix
Observation

Stack container status for an AI observer

Changed on

Returns one stack's containers projected for an Observe Only token: name, service, state, health, restart count, exit code, and start time. The response carries at most 100 containers and sets truncated when the stack has more. An outcome of unavailable is a successful response meaning the node could not read its own containers at that moment; the container list is empty and a later call may succeed. 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/status

Request

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

Container facts wrapped in the observation envelope.

schemaVersion1 required
generatedAtinteger required

Epoch ms of the evidence behind the answer.

Changes