agents

List Passages

Retrieve the memories in an agent's archival memory store (paginated query).

get/v1/agents/{agent_id}/archival-memory

Request

  • Base URL
    https://app.letta.com
  • URL
    https://app.letta.com/v1/agents/{agent_id}/archival-memory
  • Auth
    HTTP bearer

Path parameters

agent_idstring required

Query parameters

afterstring nullable

Unique ID of the memory to start the query range at.

beforestring nullable

Unique ID of the memory to end the query range at.

limitinteger nullable

How many results to include in the response.

searchstring nullable

Search passages by text

ascendingboolean nullable

Whether to sort passages oldest to newest (True, default) or newest to oldest (False)

Response

Successful Response

created_by_idstring nullable

The id of the user that made this object.

last_updated_by_idstring nullable

The id of the user that made this object.

created_atstring date-time

The creation date of the passage.

updated_atstring date-time nullable

The timestamp when the object was last updated.

is_deletedboolean

Whether this passage is deleted or not.

archive_idstring nullable

The unique identifier of the archive containing this passage.

source_idstring nullable

The data source of the passage.

file_idstring nullable

The unique identifier of the file associated with the passage.

file_namestring nullable

The name of the file (only for source passages).

metadataobject nullable

The metadata of the passage.

tagsstring[] nullable

Tags associated with this passage.

idstring

The human-friendly ID of the Passage

textstring required

The text of the passage.

embeddingnumber[] nullable required

The embedding of the passage.

Example response

[
  {
    "id": "passage-123e4567-e89b-12d3-a456-426614174000"
  }
]

Changes

No recorded changes to this operation across all 36 revisions of this API.