Skip to main content
GET
TypeScript SDK

Authorizations

x-api-key
string
header
required

Long-lived org API key. Alternative: Authorization: Bearer <key>.

Query Parameters

user_id
string | null

Filter by user_id (exact match). Combine with other entity params for AND.

agent_id
string | null

Filter by agent_id (exact match).

conv_id
string | null

Filter by conv_id (exact match).

app_id
string | null

Filter by app_id (exact match).

group_id
string | null

Filter to rows tagged with this group id. Singular on list; the full DSL on POST /v1/memories/search supports multi-id $in filtering.

type
enum<string> | null

Restrict results to one memory subtype. Default: all three.

Available options:
fact,
artifact,
episode
cursor
string | null

Opaque pagination cursor from a previous response's next_cursor. Must match this request's order and the issuing org (mismatch → 422 cursor_mismatch).

limit
integer
default:50

Maximum rows per page. 1–500, default 50.

Required range: 1 <= x <= 500
order
enum<string>
default:created_at_desc

Sort order on (created_at, id).

Available options:
created_at_desc,
created_at_asc
include
string | null

Comma-separated opt-in extras. Currently only full_content is supported (populates details.full_content on artifact rows).

Response

Successful Response

Stripe-style list envelope used by GET /v1/memories, GET /v1/memories/{id}/revisions, and the default search response.

object
string
default:list

Constant discriminator for the resource type.

Allowed value: "list"
data
Memory · object[]

Page of memory rows.

has_more
boolean
default:false

True if more rows exist beyond this page; use next_cursor to fetch them.

next_cursor
string | null

Opaque cursor for the next page. Null on the final page. Tenant-scoped: only usable with the same (org, key) that produced it.