Read and follow logs

Read logs at GET /workspaces/{workspaceId}/services/{serviceId}/logs. Responses contain retained build, runtime, or system output available to the caller.

Read the newest batchCopy Anchor Link

curl --fail-with-body --get \
  --header "Authorization: Bearer $OPENSTEAD_API_KEY" \
  --data-urlencode 'source=runtime' \
  --data-urlencode 'limit=100' \
  "https://api.openstead.tech/api/v1/workspaces/$OPENSTEAD_WORKSPACE_ID/services/$OPENSTEAD_SERVICE_ID/logs"

{
  "available": true,
  "items": [
    {
      "id": 42,
      "timestamp": "2026-09-28T12:00:00Z",
      "source": "runtime",
      "message": "Application ready",
      "level": "info"
    }
  ],
  "cursor": 42,
  "hasMore": false,
  "limit": 100
}

The first request retrieves the newest retained batch, ordered by numeric ID ascending. It is not an export of all historical lines.

Follow later linesCopy Anchor Link

Pass the previous response's numeric cursor as after. Preserve the other filters:

GET .../logs?source=runtime&limit=100&after=42

When hasMore is true, request the next batch immediately. When false, pause before polling again. A cursor should advance when new matching lines are returned. The SDKs detect non-advancing continuation loops.

FiltersCopy Anchor Link

Persist the service, cursor, and filters together when resuming a reader. Changes to filters, retention expiry, and a late restart can leave gaps. There is no collection-style page envelope or opaque cursor here.

SDK helpersCopy Anchor Link

Python logs.iter() drains available batches and logs.tail() polls for new lines. TypeScript provides logs.batches() and logs.tail().

import os
from openstead import PollTimeout, Openstead

with Openstead() as client:
    try:
        for line in client.logs.tail(
            workspace_id=os.environ["OPENSTEAD_WORKSPACE_ID"],
            service_id=os.environ["OPENSTEAD_SERVICE_ID"],
            source="runtime",
            timeout=30.0,
        ):
            print(line.timestamp, line.level, line.message)
    except PollTimeout:
        pass

Choose a suitable destination for output: applications can log credentials, customer data, and other sensitive information.

Unavailable logsCopy Anchor Link

A response may return available: false, an empty items array, and a reason without cursor metadata. Inspect that response before interpreting a quiet log reader as a healthy application. Tailing is HTTP polling over retained records, with no guarantee of an exhaustive archive.