Read an app's current-instance logs

GET/apps/{name}/logs

Durable logs (service output + exec activity) of the app's current instance; same shape as GET /sandboxes/{id}/logs. 409 when the app has no running instance, 501 with no log store.

path parameters

object

namestringrequired

App name (a DNS label, e.g. web).

query parameters

object

sinceintegerint64

Byte offset to read from; -1 (default) tails the recent log.

sourcestring

Filter by source: service | exec | all (default all).

Responses

200 OKOK

LogsResponse

next_offsetintegerint64

recordsarray | null

items

LogRecord

sourcestring

streamstring

textstring

time_msintegerint64

400 Bad requestBad Request

ErrorResponse

errorstring

404 Not foundNot Found

ErrorResponse

errorstring

409 ConflictConflict

ErrorResponse

errorstring

501 Not Implemented

ErrorResponse

errorstring

Authentication

bearerAuthHTTP bearer. Daemon API key. Omit on a keyless loopback daemon.

Request

▍GET/apps/{name}/logs

cURL

curl '/apps/{name}/logs?since=&source='

JavaScript

const response = await fetch("/apps/{name}/logs?since=&source=", {
  method: "GET",
});
const data = await response.json();

Python

import requests

response = requests.get(
    "/apps/{name}/logs?since=&source=",
)
data = response.json()

Response

200 OK

{
  "next_offset": 0,
  "records": [
    {
      "source": "string",
      "stream": "string",
      "text": "string",
      "time_ms": 0
    }
  ]
}