Skip to content
GitHub

Log lines of the app's pods (at most 10 pods): the recent ones, or with `follow=true` a live stream of new ones.

GET
/api/v1/projects/{project}/environments/{environment}/apps/{app}/logs
curl --request GET \
--url https://example.com/api/v1/projects/example/environments/example/apps/example/logs
project
required
string

Project name

environment
required
string

Environment short name

app
required
string

App name

tail
integer format: int64

Lines per pod (1–2000, default 200).

process
string

Only pods of this process.

previous
boolean

Logs of the previous (crashed) container instance.

follow
boolean

Keep the connection open and send new lines as text/event-stream: line events (a [LogLine]) and an end event (a [LogEnd]) when a pod’s log stops or the stream reaches its hour.

Recent lines per pod; with follow, text/event-stream of line (LogLine) and end (LogEnd) events

Media typeapplication/json
Array<object>
object
pod
required
string
process
string | null
lines
required
Array<string>
error

Why no logs could be read (e.g. the container is still starting).

string | null
Examplegenerated
[
{
"pod": "example",
"process": "example",
"lines": [
"example"
],
"error": "example"
}
]

Too many followed logs open

Media typeapplication/json

Problem Details body.

object
code
required

Stable machine-readable code, e.g. forbidden.

string
title
required

Short human readable title.

string
status
required

HTTP status.

integer format: int32
detail

Details, if safe to expose.

string | null
Example
{
"code": "forbidden"
}
Media typeapplication/json

Problem Details body.

object
code
required

Stable machine-readable code, e.g. forbidden.

string
title
required

Short human readable title.

string
status
required

HTTP status.

integer format: int32
detail

Details, if safe to expose.

string | null
Example
{
"code": "forbidden"
}