Skip to main content
TroopyDocs
Open Troopy
Troopy

API reference / Tests and incidents

List the incident apps

The apps that send their errors to Troopy with a Sentry SDK, each with its DSN. 20 at most.

get/api/v1/incident-apps

Authorization

HeaderAuthorization: Bearer <API key>
Or the headerX-API-Key: <API key>
API keyMake one in Troopy under Settings > API keys. It acts as you, in its workspace.

Other ways to call it

CLItroopy incidents apps
MCP tooltroopy_list_incident_apps
Rate limit120 calls in 60 seconds, for each key

Response

200 · application/json
data*array<object>
18 properties
id*string

A 24-character id

name*string
slug*string

The name as an identifier, like web-app: unique in the workspace

platform*enum<string>

websitenextjsnodepythonother

projectId*integer

The number at the end of the DSN: a Sentry SDK needs a number

dsn*string | null

What the app's Sentry SDK takes, with its newest key. null when incidents are off on this server

keys*array<object>

Its keys, newest first. A rotation keeps the old key for a while

3 properties
key*string

The public key of the DSN: 32 hex. It is not a secret: it is in the app's code

createdAt*string

ISO 8601 date and time

retiresAt*string | null

When it stops working, after a new key came. null: it works

origins*array<string>

Sites that may send its errors from a browser, like https://app.example.com. Empty: any site

limits*object

Errors that it sends in a minute and in a day. Troopy drops the rest

2 properties
perMinute*integer
perDay*integer
keepEmails*boolean

Whether Troopy keeps the email of the person that an error names. Off: a code takes its place

keepIp*boolean

Whether Troopy keeps the IP address of the person that an error names

paused*boolean

A paused app's errors go nowhere: Troopy drops them

environments*array<string>

The environments that its errors named, like production

releases*array<object>

The releases that its errors named, newest first

2 properties
version*string
firstSeenAt*string

ISO 8601 date and time

lastEventAt*string | null

When its latest error came

createdBy*object

Who wrote it

3 properties
type*enum<string>

personagentapi

id*string
name*string
createdAt*string

ISO 8601 date and time

updatedAt*string

ISO 8601 date and time

Errors

401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask an organization owner or admin.
429 rate_limitedWait the number of seconds in Retry-After, then retry.