Skip to main content
GET
List an app's installations, with their webhooks' health

Authorizations

Authorization
string
header
required

The dashboard's session token (Authorization: Bearer <JWT>), as the console sends it. Never paste it into a terminal: it opens every business the user belongs to.

Path Parameters

appId
string
required

One of your apps' ids. Another developer's app, or a malformed id, is 404 APP_NOT_FOUND.

Pattern: ^\d{1,20}$

Query Parameters

status
enum<string>
Available options:
active,
suspended,
uninstalled
limit
integer

Page size, 1 to 100. A value outside that range is 400.

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

The nextCursor of the previous page, unchanged, with the same filters.

Maximum string length: 512

Response

One page of installations.

One page, newest first.

data
object[]
required
nextCursor
string | null
required

Pass it back as cursor (with the same filters) for the next page; null on the last.