memory

A store’s image memories, newest first

Cursor paging, never an offset: hand next_before and next_skip_ids back as before and skip_ids. A bulk write stamps many memories with the SAME instant, so cutting on time alone silently drops the rest of that instant. count is the store total, so you can show “142 images” without walking every page.

post/api/v1/memory/images

Request

  • Base URL: https://api.wontopos.com
  • URL: https://api.wontopos.com/api/v1/memory/images
  • 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.

limitinteger

Per page, 5–20 (default 20). Out of range is refused, not clamped.

beforestring

Cursor: next_before from the previous page (RFC3339).

skip_idsstring[]

Cursor: next_skip_ids from the previous page. Accumulates across pages.

Response

Success.

user_idstring
countinteger

Image memories in the whole store, not on this page.

has_moreboolean
next_beforestring nullable
next_skip_idsstring[]

Changes

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