Skip to main content

Memories

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 as memoryId to updateMemory or deleteMemory.
    • text (string, required): What the slides agent remembers, such as Our 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 is text. One of structure, titles, text, numbers, charts, design, workflow, metrics.
    • report (object or null, required): The report it holds for. null when it holds for all your reports.
      • id (string, required): The report's id.
      • 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 its id from listReports, which you must be able to edit. null for all your reports. Defaults to null.

Response 201

Success

application/json

  • id (string, required): Identifies the memory. Pass it as memoryId to updateMemory or deleteMemory.
  • text (string, required): What the slides agent remembers, such as Our 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 is text. One of structure, titles, text, numbers, charts, design, workflow, metrics.
  • report (object or null, required): The report it holds for. null when it holds for all your reports.
    • id (string, required): The report's id.
    • 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 its id from listMemories.

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 its id from listReports, which you must be able to edit. null for all your reports. If omitted, it stays.

Response 200

Success

application/json

  • id (string, required): Identifies the memory. Pass it as memoryId to updateMemory or deleteMemory.
  • text (string, required): What the slides agent remembers, such as Our 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 is text. One of structure, titles, text, numbers, charts, design, workflow, metrics.
  • report (object or null, required): The report it holds for. null when it holds for all your reports.
    • id (string, required): The report's id.
    • 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 its id from listMemories.

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