API reference / Account
Your notifications
What Troopy told you about in this workspace, the newest first: decisions that wait for you, work to review, drafts, replies and more, as you chose in Settings > Notifications. Pass next as cursor for the page after.
/api/v1/me/notificationsOther ways to call it
troopy notifications listQuery parameters
unreadboolean | enum<string>true: only what you have not read
truefalse
limitintegerAt most 100
Default 30 · At least 1 · At most 100
cursorstringThe next value from the previous page
At most 200 characters
Response
200 · application/jsondata*array<object>9 properties
id*stringA 24-character id
kind*enum<string>decisionreviewtaskdraftreplymailroutine_doneroutine_failedweeklyremindersessionmentionvisitor
by*object | nullWho did it. Null for Troopy itself
4 properties
type*enum<string>personagentapi
id*stringname*stringhandle*string | nullA teammate's handle, for its face. Null for a person, or for a teammate that left
verb*stringThe words between the name and the title, like needs your decision on
title*stringWhat it is about, like VIR-12 Write the newsletter
text*stringIts first words
href*stringIts page in the app, as a path
read*booleanat*stringISO 8601 date and time
unread*integerWhat is still unread in the bell
next*string | nullPass as cursor for the next page; null on the last