Skip to main content
POST
Write a memory

Authorizations

Authorization
string
header
required

Workspace API key. Create one via the dashboard or POST /v1/auth/keys.

Body

application/json
content
string
required

The text to remember.

Maximum string length: 200000
title
string
Maximum string length: 255
kind
enum<string>
Available options:
document,
note,
conversation,
observation,
maintenance
knowledge_base_id
string<uuid>

Knowledge base to scope to; defaults to the company default.

document_id
string<uuid>
source
string

Provenance label.

source_ref
string
confidence
number
Required range: 0 <= x <= 1
metadata
object
type
enum<string>

Typed outcome for the belief lifecycle.

Available options:
observation,
finding,
decision,
correction,
question,
artifact
contradicts
string<uuid>[]

Claim ids this memory invalidates.

supports
string<uuid>[]

Claim ids this memory corroborates.

premised_on
string<uuid>[]

Claim ids the work was premised on.

Response

Written canonically (shadow gateway mode).

mode
string
canonical_write
boolean
episode
object
claims
object[]
count
integer
reconciliation
object