memory

One-call LLM context

Short-term turns + long-term matches + surrounding context in one bounded call.

post/api/v1/memory/recall

Request

  • Base URL: https://api.wontopos.com
  • URL: https://api.wontopos.com/api/v1/memory/recall
  • Auth: API key in header X-API-Key

Headers

X-WOS-Modelstring

Which engine reads the memory (see GET /api/v1/models). All live models share one memory per workspace, so you can store with one and recall with another. A retired model answers 410 with error.type gone_error and error.code 0, except on DELETE /api/v1/memory/collection, which deletes the store under any model. Until then, a model scheduled to retire names the day in a Sunset header (RFC 8594) on every answer it serves, the same date GET /api/v1/models lists as retires_at.

Request body

user_idstring required

The store to operate on. Stores are explicit: create one first or use the built-in "default". Use the id the store was created with: 1-64 ASCII letters, digits, ., _ or -, starting with a letter or digit. Ids that differ only by case name one store.

querystring required
limitinteger

Long-term memories to recall. Out of range is refused, not clamped — asking for 20 and silently getting 10 reads as "that is all there is".

context_limitinteger

How much surrounding context is attached around the best match. 0 attaches none.

form'memoir' | 'archive'

Render each returned memory’s time in this form (Scroll 1.2 and newer; HTTP header equivalent: X-WOS-Form). An unknown form is a 400.

tzinteger

UTC offset in hours, used only while a form renders the times.

Response

Success.

short_termobject
contextobject

Changes

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