Skip to main content
POST
Append a new memory (mirrors the MCP remember tool)

Authorizations

X-API-Key
string
header
required

Body

application/json
content
string
required
Required string length: 1 - 2000
memoryType
enum<string>
required
Available options:
decision,
commitment,
blocker,
fact,
preference,
pattern,
note,
event
topic
string
required
Required string length: 1 - 256
dueAt
string<date-time> | null

Commitments only: the explicit deadline, as a UTC ISO-8601 instant ending in Z (e.g. 2026-11-30T17:00:00Z) with at most 3 fractional-second digits. Past this instant the commitment reads as overdue in briefing. Omit (or null) for an undated commitment; never inferred from content.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
facts
object[]
Maximum array length: 16
owner
string

Commitments only: who owns the commitment, as a short label. Omit when unknown.

Required string length: 1 - 256
project
string
Required string length: 1 - 256
scope
string

Scope to file the memory under. Omitted: your write-scope policy decides (default 'personal').

Required string length: 1 - 64
Pattern: ^[a-z0-9][a-z0-9-]*$
sessionRunId
string<uuid>

Opaque id of the current agent session run. Pass through from SessionStart. Omit to attach the single leased-open session for this project, if any. A run id not owned by this tenant fails the write.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
tags
string[]
Maximum array length: 32
Required string length: 1 - 64

Response

Success

embedded
enum<string>
required
Available options:
pending,
done,
failed,
off
memory
object
required
commitmentId
string<uuid>
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
factIds
string<uuid>[]
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$