Skip to main content
POST
Save a memory

Authorizations

Authorization
string
header
default:Bearer uk_live_your_api_key_here
required

Versuno API key. Must be prefixed with Bearer. Format: Bearer uk_live_...

Body

application/json
content
string
required
Minimum string length: 1
Example:

"The project uses pnpm, not npm."

canonical
string | null

Optional short title for the memory.

Example:

"package-manager"

summary
string | null
type_hint
enum<string> | null
Available options:
fact,
preference,
episode,
procedure
Example:

"fact"

source
string

Optional channel/app the agent is writing from. Defaults to mcp.

Example:

"claude-desktop"

location
string | null

Optional conversation/context id. No file backs an agent write.

Response

The write outcome.

id
string<uuid>
action
enum<string>

add = stored new; dedup = merged into an existing memory; conflict = stored but contradicts existing memory (resolve via /memory/resolve).

Available options:
add,
dedup,
conflict
conflict
object | null

Present only when action is conflict; the incoming memory plus the conflicting candidates.