Skip to main content

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.