API reference / Troop
Rewrite a memory file
Replaces a memory file's whole text, in markdown, at most 10,000 characters. Shared files change what every teammate reads, so keep the most important lines first. about writes your own About you. When a teammate calls this, it waits for a person's approval.
patch
/api/v1/memory/{file}Other ways to call it
CLI
troopy memory updateMCP tool
troopy_update_memory_fileRate limit30 calls in 60 seconds, for each key
RetriesSend an
Idempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Path parameters
file*enum<string>company, contacts, glossary, troop, voice, email, or about for your own
companycontactsglossarytroopvoiceemailabout
Body
application/jsontext*stringThe file's new text, in markdown
At most 10000 characters
Response
200 · application/jsondata*object8 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
400 invalid_inputFix the field named in detail. Each operation's schema is in /api/v1/openapi.json.
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.
404 not_foundCheck the path and any id in it. Every operation is listed in /api/v1/openapi.json.
409 conflictThis Idempotency-Key was used for a different request, or that request is still running. Use a new key for a new request.
429 rate_limitedWait the number of seconds in Retry-After, then retry.