Skip to main content
GET
List Apps

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

Query Parameters

limit
integer
default:50

The maximum number of Apps 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 Apps.

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

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

slug
string

Returns only Apps whose slug contains this text, ignoring case.

Required string length: 1 - 200
include_deleted
boolean
default:false

If true, includes deleted Apps. If false, lists only Apps that aren't deleted.

Response

One page of Apps.

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.