Memories
- OpenAPI 3.1.0 document: https://api.rollstack.com/public/v1/openapi.json
- The whole reference in Markdown: https://docs.rollstack.com/llms-full.txt
- An index of the reference: https://docs.rollstack.com/llms.txt
What the slides agent remembers of how you like your decks, such as your fiscal year or how you name regions, as in the Slides settings of the app. It learns them in your chats and reads them while your organization has slide memories on and you have it remember your preferences. They are yours alone: another member has their own.
See them with listMemories, add one with createMemory, for all your reports or one of them, change one with updateMemory and forget one with deleteMemory.
List memories
GET https://api.rollstack.com/public/v1/memories
What the slides agent remembers of how the user likes their decks, as the app's Slides settings list it: each memory, the part of a deck it is about, and the report it holds for, if only one. Read them before adding one, so as not to repeat one.
Requires the slide_decks:read scope.
Operation ID: listMemories.
Response 200
Success
application/json
data(array of object, required): What the slides agent remembers of how you like your decks, newest first: what it learned in your chats and decks and what you added. They are yours alone, and the agent reads them while your organization has slide memories on and you have it remember your preferences, in the app.id(string, required): Identifies the memory. Pass it asmemoryIdtoupdateMemoryordeleteMemory.text(string, required): What the slides agent remembers, such asOur fiscal year starts in February.category(string, required): The part of a deck it is about, so each agent reads the ones it acts on. One you add istext. One ofstructure,titles,text,numbers,charts,design,workflow,metrics.report(object or null, required): The report it holds for.nullwhen it holds for all your reports.id(string, required): The report'sid.name(string, required): The report's name.
updatedAt(string, required): When it was last learned or changed, as an ISO 8601 date and time.
Add memory
POST https://api.rollstack.com/public/v1/memories
Has the slides agent remember something of how the user likes their decks, for all their reports or one of them, as adding a preference in the app's Slides settings does. Only add what the user asked to be remembered. Answers the memory.
Requires the slide_decks:write scope.
Operation ID: createMemory.
Headers
Idempotency-Key(string): A unique value, such as a UUID, that makes retrying this call safe. A retry with the same key within 24 hours answers the first call's result instead of running it again. Use a new key for each new call. From 1 to 255 printable ASCII characters.
Request body, required
application/json
text(string, required): What the slides agent should remember, as one plain sentence, at most 300 characters. Example:Our fiscal year starts in February.reportId(string or null): The report the memory holds for, by itsidfromlistReports, which you must be able to edit.nullfor all your reports. Defaults tonull.
Response 201
Success
application/json
id(string, required): Identifies the memory. Pass it asmemoryIdtoupdateMemoryordeleteMemory.text(string, required): What the slides agent remembers, such asOur fiscal year starts in February.category(string, required): The part of a deck it is about, so each agent reads the ones it acts on. One you add istext. One ofstructure,titles,text,numbers,charts,design,workflow,metrics.report(object or null, required): The report it holds for.nullwhen it holds for all your reports.id(string, required): The report'sid.name(string, required): The report's name.
updatedAt(string, required): When it was last learned or changed, as an ISO 8601 date and time.
Update memory
PATCH https://api.rollstack.com/public/v1/memories/{memoryId}
Rewords a memory of the slides agent, or moves it to one report or all of them. What you send changes and the rest stays. Answers the memory.
Requires the slide_decks:write scope.
Operation ID: updateMemory.
Path parameters
memoryId(string, required): The memory to act on, by itsidfromlistMemories.
Headers
Idempotency-Key(string): A unique value, such as a UUID, that makes retrying this call safe. A retry with the same key within 24 hours answers the first call's result instead of running it again. Use a new key for each new call. From 1 to 255 printable ASCII characters.
Request body, required
application/json
text(string): What the slides agent should remember, as one plain sentence, at most 300 characters. Example:Our fiscal year starts in February.reportId(string or null): The report the memory holds for, by itsidfromlistReports, which you must be able to edit.nullfor all your reports. If omitted, it stays.
Response 200
Success
application/json
id(string, required): Identifies the memory. Pass it asmemoryIdtoupdateMemoryordeleteMemory.text(string, required): What the slides agent remembers, such asOur fiscal year starts in February.category(string, required): The part of a deck it is about, so each agent reads the ones it acts on. One you add istext. One ofstructure,titles,text,numbers,charts,design,workflow,metrics.report(object or null, required): The report it holds for.nullwhen it holds for all your reports.id(string, required): The report'sid.name(string, required): The report's name.
updatedAt(string, required): When it was last learned or changed, as an ISO 8601 date and time.
Forget memory
DELETE https://api.rollstack.com/public/v1/memories/{memoryId}
Has the slides agent forget a memory: its runs stop reading it, as forgetting it in the app's Slides settings does.
Requires the slide_decks:write scope.
Operation ID: deleteMemory.
Path parameters
memoryId(string, required): The memory to act on, by itsidfromlistMemories.
Headers
Idempotency-Key(string): A unique value, such as a UUID, that makes retrying this call safe. A retry with the same key within 24 hours answers the first call's result instead of running it again. Use a new key for each new call. From 1 to 255 printable ASCII characters.
Response 204
Success, no content