speakers

What one person said, newest first

speaker is the tag written at store time — "me" for the assistant’s own words, otherwise a registered name. Same cursor paging as /images. chunks and records_to_delete say how much a delete would actually remove, which is usually more than returned — worth showing someone before they confirm one. (points_to_delete is the same number under a deprecated name.)

post/api/v1/memory/by-speaker

Request

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

speakerstring required

"me" for the assistant, or a registered person.

limitinteger

Per page, 5–20 (default 20).

beforestring

Cursor: next_before from the previous page.

skip_idsstring[]

Cursor: next_skip_ids, accumulated.

Response

Success.

user_idstring
speakerstring
returnedinteger
chunksinteger

How much a delete here would remove — usually more than returned.

records_to_deleteinteger

The same count. Prefer this name.

points_to_deleteinteger

Deprecated alias of records_to_delete; both carry the same value. Read records_to_delete.

has_moreboolean
next_beforestring nullable
next_skip_idsstring[]

Changes

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