Skip to main content
TroopyDocs
Open Troopy
Troopy

API reference / Account

What Troopy tells you about

Each event that Troopy can tell you about, and how: in the bell of the app, by email, or both. Your choices apply in every workspace.

get/api/v1/me/notification-settings

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 notifications settings
MCP toolNone. Call it over REST or with the CLI.
Rate limit60 calls in 60 seconds, for each key

Response

200 · application/json
data*array<object>
5 properties
kind*enum<string>

decisionreviewtaskdraftreplymailroutine_doneroutine_failedweeklyremindersessionmentionvisitor

title*string
line*string

What the event is, in one line

app*boolean

It shows in the bell of the app

email*boolean | null

It goes to you by email. Null: Troopy sends no email for this event

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.