Sign in
Memory

Retrieve Memory

Retrieves relevant or recent runs from the selected memory. Provide a query to rank results by relevance; leave it empty to return the most recent runs.

post/v1beta/memory/retrieve

Request body

querystring nullable

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

limitinteger

Maximum number of memories to return.

kind'task' | 'monitor' | 'findall' nullable

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

sincestring date-time nullable

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

memory_scope_keystring nullable

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

Example request

{
  "since": "2026-07-15T17:30:00Z"
}

Response

Successful Response

Changes