API reference / Troop
Get the memory files
What every teammate reads before it works, besides its own files: the workspace's shared files (company, contacts, glossary, troop, voice, email) and your own About you (about), which only you see and which is read whenever you ask a teammate for something.
get
/api/v1/memoryOther ways to call it
CLI
troopy memory getMCP tool
troopy_get_memoryRate limit120 calls in 60 seconds, for each key
Response
200 · application/jsondata*array<object>8 properties
file*enum<string>companycontactsglossarytroopvoiceemailabout
name*stringabout*stringWhat the file is for
text*stringMarkdown
max*integerCharacters it may hold
updatedBy*object | null3 properties
type*enum<string>personagentapi
id*stringname*stringupdatedAt*string | nulldigeststring | nullWhat each prompt holds of a long file. A teammate opens the whole file when it needs it
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.