Observation

List stacks for an AI observer

Changed on

Returns one page of the stacks on a node, projected for an Observe Only token: name, status, running and total container counts, source, and whether the stack is this instance. Stacks are ordered by name; the cursor is the name of the last stack on the previous page, so a stack deleted between two pages does not shift the rest of the list. A directory whose name has characters outside letters, digits, _, and - is not listed, because no per-stack route accepts it. degraded reports that the underlying status evidence was incomplete. This is one of the five paths an Observe Only token may reach. Requires stack:read permission.

get/api/stacks/platform/observation

Request

  • Base URL
    https://localhost:1852
  • URL
    https://localhost:1852/api/stacks/platform/observation
  • Auth
    HTTP bearer

Query parameters

cursorstring

Name of the last stack on the previous page. Omit for the first page.

limitinteger

Page size. Defaults to 100 and accepts 1 to 200.

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

One page of stacks wrapped in the observation envelope.

schemaVersion1 required
generatedAtinteger required

Epoch ms of the evidence behind the answer.

Changes