App logs (live stream)

GET

/api/apps/{app}/logs/stream

• Public API (webhooks + management via Bearer token)
• Internal API (management, no auth required)

Server-Sent Events stream of live log output from an app’s containers. Each event has event: log with a JSON LogLine as data.

Use the since parameter (ISO 8601 timestamp) to avoid duplicates when transitioning from the historical endpoint to live streaming.

The stream stays open until the client disconnects. Docker log streams are only held open while a client is connected.

Authorizations

• bearerToken
• None

Parameters

Path Parameters

app

required

string

/^[a-z0-9][a-z0-9-]*$/

Example

my-app

App ID

Query Parameters

includeNeeds

string

Allowed values: true

Include infrastructure containers (postgres, valkey, garage)

since

string format: date-time

Example

2026-03-13T10:00:05.012Z

Only return logs after this ISO 8601 timestamp

Responses

200

SSE stream of log lines

Each event is formatted as:

event: log
data: {"service":"web","stream":"stdout","timestamp":"...","message":"...","isNeeds":false}

string

503

API key not configured (port 6020 only)