Skip to content

Get App Logs

GET
/apps/{app_id}/logs

What the running app is printing.

The app’s own pods only. The per-app egress proxy runs in the same namespace and is deliberately excluded: it is platform infrastructure that happens to live inside a tenant boundary, and its output is graph8’s, not the builder’s.

Empty until a deployment reaches deployed. The app Deployment ships with replicas: 0 and a pause image, so a namespace that exists still has no app pod to read until a build has been promoted.

Authorizations

Parameters

Path Parameters

app_id
required
string

Query Parameters

tail_lines

Lines per replica, newest last.

integer
default: 200 >= 1 <= 2000

Lines per replica, newest last.

Header Parameters

X-Org-Id
Any of:
string

Responses

200

Successful Response

object
data
required

Logs for one app or one of its builds.

redacted is always true and means only that graph8’s credential patterns were applied. It is NOT a claim the output is safe to publish: these are a customer’s own build and application logs, and an application can print a secret in a shape no pattern matches.

object
app_id
required
string
containers
Array<object>

One container’s tail of output.

A build is five steps in one pod (fetch, scan-source, build, scan-image, push), so a single flat blob would leave a caller unable to say which step failed. kind separates the four init steps from the one container, which is the ordering Kubernetes actually runs them in.

object
container
required
string
kind
required
string
Allowed values: init container
pod
required
string
text
required
string
truncated

The tail hit the per-container byte cap. Earlier output exists and was not returned.

boolean
deployment_id
Any of:
string
namespace
required

The app’s own Kubernetes namespace. Derived from the app id, never supplied.

string
redacted
boolean
default: true
tail_lines
required

Lines requested per container, after clamping to the server maximum.

integer
pagination
Any of:
object
has_next
required

Whether there are more pages

boolean
limit
required

Items per page

integer
next_cursor
Any of:
string
page
required

Current page number (1-indexed)

integer
total
required

Total number of items

integer

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string