Skip to main content
GET
List logs

Authorizations

Authorization
string
header
required

An API token for one organization. You create and revoke tokens in the dashboard. A token scoped to one App can reach only that App, so give that kind of token to an agent. An organization-wide token can create a short-lived one with POST /api/tokens.

Scopes

apps:read
OAuth

See the organization's Apps, with their files, deployments, and logs.

apps:read
DPoP

Path Parameters

id
string
required

A unique ID that starts with app_.

Pattern: ^app_[0-9A-Za-z]{24}$
Example:

"app_Zj7XhMgplmTJcp5Dk4vcYuk0"

Query Parameters

limit
integer
default:50

The maximum number of log entries to return.

Required range: 1 <= x <= 100
cursor
string

Where to start: the next_cursor of the page before, listed with the same sort. Without it, the list starts with the first log entries.

Required string length: 1 - 4096
sort
string
default:-created_at

A comma-separated list of fields to sort by: created_at. Each field sorts ascending. To sort a field descending, prefix it with -. Ties are sorted by id.

message
string

Returns only log entries whose message contains this text, ignoring case.

Required string length: 1 - 200
environment
enum<string>

Returns only entries from the published App (production) or from its sandbox (development).

Available options:
production,
development
source
string

Returns only entries from these sources. Separate values with commas. Values: request, app, dev_server, runtime, deployment, platform.

level
string

Returns only entries at these levels. Separate values with commas. Values: debug, info, warn, error.

trace_id
string

Returns only the entries of one request, by its trace_id.

Pattern: ^[0-9a-f]{32}$
since
string<date-time>

Returns only entries at or after this time.

Example:

"2026-10-03T14:01:30.000Z"

until
string<date-time>

Returns only entries before this time. To page through a fixed window while new entries arrive, set it to the time of your first request.

Example:

"2026-10-03T14:01:30.000Z"

Response

One page of log entries.

results
object[]
required

The results in this page.

has_more
boolean
required

True if more results follow this page; false otherwise.

next_cursor
string | null
required

Where the next page starts: to get it, list again with this value as cursor. A cursor from the last page later finds results added after it. Null if the list is empty.