API reference / Troop
List a teammate's email
The emails that a teammate's own address received and sent, newest first, kept 30 days. Codes and links are masked: a teammate types and opens them by reference, and only owners and admins reveal them, in the app.
/api/v1/agents/{handle}/inboxOther ways to call it
troopy agents inboxtroopy_list_teammate_emailPath parameters
handle*stringThe teammate's handle, like chief
At most 40 characters
Query parameters
pageinteger1-based page number
Default 1 · At least 1
limitintegerItems per page, at most 100
Default 20 · At least 1 · At most 100
Response
200 · application/jsondata*array<object>14 properties
id*stringA 24-character id
direction*enum<string>in for an email that came, out for one that the address sent
inout
from*stringThe sender's address
fromName*stringsubject*stringCodes in it masked, like [code 1]
receivedAt*stringISO 8601 date and time
checked*booleanThe sender's domain passed DMARC: the one sign it is who it says
spam*booleanSES called it spam: the teammate doesn't see it
codes*integerHow many codes it carries. Never shown over the API: the teammate types them by reference
links*array<object>Its links' sites and words, never their addresses
3 properties
n*integersite*stringlabel*stringto*array<string>A sent email: the addresses that it went to
status*enum<string> | nullA sent email: whether it went. unknown when it possibly went: Troopy does not send it again
sendingsentfailedunknown
error*string | nullA sent email that did not go, or possibly did not: why
textstringOne email's words, every code and link masked
pagination*object4 properties
page*integerlimit*integertotal*integerpages*integer