Memories

Add a memory

Save text or a URL. URLs are fetched and their readable content is extracted. Processing (extraction, summary, embeddings) runs in the background: the memory appears in GET /memories (and in its spaces) right away and becomes searchable when its processingStage is ready, usually within a few seconds.

post/add

Request

  • Base URL: https://api.mymemory.dev/v1
  • URL: https://api.mymemory.dev/v1/add
  • Auth: HTTP bearer

Request body

contentstring required

Text, markdown or a URL to ingest.

type'note'

Optional. Set to note to save content as a note as-is. Without it, the type is detected from content (a URL becomes a page, tweet, video and so on).

spacesstring[]

Space IDs (uuid from GET /spaces) to file the memory in. Up to 5.

tagsstring[]

Up to 20 tags. Normalized to lowercase, a leading # is removed, letters and digits in any language are kept, max 32 characters each.

metadataobject

Any JSON you want stored with the memory.

eventAtstring date-time

When the content happened, if different from when it was saved.

titlestring

Optional title. Without it one is generated.

Example request

{
  "content": "https://example.com/article"
}

Response

Accepted for processing

messagestring
idstring

The new memory's ID. Use it with /memories/{id}.

typestring

The detected type (note, page, tweet, …).

Example response

{
  "message": "Content added successfully"
}

Changes

No recorded changes to this operation across all 1 revision of this API.