Fetch process logs.

Returns buffered log entries for a process. Supports filtering by stream type, tail count, and sequence-based resumption. When follow=true, returns an SSE stream that replays buffered entries then streams live output.

GET /v1/processes/{id}/logs

Fetch process logs.

cURL

curl --request GET \
  --url http://localhost:2468/v1/processes/{id}/logs

200

{
  "entries": [
    {
      "data": "<string>",
      "encoding": "<string>",
      "sequence": 1,
      "stream": "stdout",
      "timestampMs": 123
    }
  ],
  "processId": "<string>",
  "stream": "stdout"
}

Path Parameters

id · string · required

Process ID

Query Parameters

stream · enum<string>

stdout|stderr|combined|pty

Available options: stdout, stderr, combined, pty

tail · integer | null

Tail N entries

Required range: x >= 0

follow · boolean | null

Follow via SSE

since · integer<int64> | null

Only entries with sequence greater than this

Required range: x >= 0

Response

200

application/json

Process logs

entries · object[] · required

Show child attributes

processId · string · required

stream · enum<string> · required

Available options: stdout, stderr, combined, pty