Skip to main content
GET
List an agent's memory runs

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Headers

x-tenant-id
string

Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.

Minimum string length: 1
x-organization-id
string

Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.

Minimum string length: 1

Path Parameters

agentId
string<uuid>
required

Agent whose automatic memory runs are listed.

Query Parameters

cursor
string

Opaque nextCursor from the previous memory run page.

limit
integer
default:50

Page size from 1 through 100, default 50.

Required range: 1 <= x <= 100

Response

OK

items
object[]
required

Memory runs for this page, newest first.

nextCursor
null | string
required

Cursor for the next page, or null at the end.

total
integer<int64>
required

Memory runs for this agent.

Required range: 0 <= x <= 9007199254740991