Skip to main content
POST
Retrieve Memory

Authorizations

x-api-key
string
header
required

Body

application/json
query
string | null

Concise query describing the memories to retrieve. Empty queries return the most recent memories.

Maximum string length: 500
limit
integer
default:10

Maximum number of memories to return.

Required range: 1 <= x <= 25
kind
enum<string> | null

Filter memories by kind: task, monitor, or findall.

Available options:
task,
monitor,
findall
since
string<date-time>

Only return memories sourced from task, monitor, or FindAll runs completed at or after this RFC 3339 timestamp.

Example:

"2026-07-15T17:30:00Z"

memory_scope_key
string | null

User-provided key identifying the memory scope to use. Omit to use personal memory, if available.

Required string length: 1 - 128
Pattern: ^[a-zA-Z0-9_-]+$

Response

Successful Response

results
(TaskMemoryResult · object | MonitorMemoryResult · object | FindAllMemoryResult · object)[]
required