Skip to main content
GET
List External Apps
Returns only the apps you may manage: those whose management home you hold apps:manage at. Apps come in creation order, a page at a time. limit is 1 to 100 (a larger value is 400 too_big; the default is 100). While meta.hasMore is true, pass meta.nextCursor as cursor to read the next page; a cursor is bound to this route and your credential, and any other cursor answers 400 Invalid cursor. An app you may not manage is left out after each page is read, so a page may be short, or empty, while more follow.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Query Parameters

limit
integer
default:100

Items per page, 1 to 100 (default 100); a larger value is a 400 too_big. A page may hold fewer items than limit while meta.hasMore is true; continue with meta.nextCursor.

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

The previous page's meta.nextCursor; any other value is 400.

Minimum string length: 1

Response

External App list

data
object[]
required
meta
object
required

A list page's continuation. While hasMore is true, nextCursor is a string: pass it as cursor for the next page. hasMore: false ends the list; with truncated: true, more exist past what this list reads, and no cursor reaches them.