Skip to main content
GET
List Apps

Authorizations

Authorization
string
header
required

A Fly API token with access to the requested organization or resource. Send it as Authorization: Bearer <Fly API token>.

Query Parameters

org_slug
string
required

The org slug, or 'personal', to filter apps

app_role
string

Filter apps by role

limit
integer

The number of apps to fetch (must be between 1 and 5000). Providing a limit enables pagination. Without it, all apps are returned in one response.

cursor
string

Value of next_cursor from the previous page. Requires limit. Later pages only include apps that existed when the first page was requested. Apps created in the seconds before the first page was requested may be missing. Cursors expire 30 minutes after the first page was requested.

Response

OK

apps
object[]

The apps on this page, or all apps if limit was not provided.

next_cursor
string

Pagination cursor for the next page. Absent when no more apps remain. Cursors expire 30 minutes after the first page was requested.

total_apps
integer

The number of matching apps across all pages. With an organization-wide token, it is counted when the first page is requested and not updated afterwards, so it excludes apps created later and includes apps deleted while paginating. With an app-scoped token, such as a deploy token, it is recounted on each page and includes only the apps the token can read. Either way, it may differ slightly from the number of apps returned.