Get agent memories for a room

GET 
/agents/:agentId/:roomId/memories

Retrieves memories (message history) for a specific agent in a specific room

Request

Path Parameters

agentId uuidrequired

ID of the agent

roomId uuidrequired

ID of the room (conversation context)

Responses

200

List of memories

application/json

Schema

Schema

agentIduuid
roomIduuid
memoriesobject[]

Array [

iduuid

Unique identifier for the memory

userIduuid

ID of the user associated with this memory

agentIduuid

ID of the agent associated with this memory

createdAtint64

Unix timestamp when the memory was created

contentobject

textstring

Text content of the message

actionstring

Action associated with the message (if any)

sourcestring

Source of the message (e.g., "direct", "hyperfi")

urlstring

URL associated with the message (if any)

inReplyTostring

ID of the message this is in reply to (if any)

attachments

object[]

List of attachments

Array [

idstring

Unique identifier for the attachment

urlstring

URL or path to the attachment file

titlestring

Title of the attachment

sourcestring

Source of the attachment

descriptionstring

Description of the attachment

textstring

Text content extracted from the attachment (if applicable)

contentTypestring

MIME type of the attachment

]

embeddingfloat[]

Vector embedding for semantic search

roomIduuid

ID of the room this memory belongs to

uniqueboolean

Whether this memory is unique

similarityfloat

Similarity score (if this was retrieved via search)

]

Example (from schema)

{
  "agentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "roomId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "memories": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "agentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "createdAt": 0,
      "content": {
        "text": "string",
        "action": "string",
        "source": "string",
        "url": "string",
        "inReplyTo": "string",
        "attachments": [
          {
            "id": "string",
            "url": "string",
            "title": "string",
            "source": "string",
            "description": "string",
            "text": "string",
            "contentType": "string"
          }
        ]
      },
      "embedding": [
        0
      ],
      "roomId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "unique": true,
      "similarity": 0
    }
  ]
}

404

Agent not found

text/plain

Schema

Schema

string

500

Error fetching memories

application/json

Schema

Schema

errorstring
Example: Failed to fetch memories

Example (from schema)

{
  "error": "Failed to fetch memories"
}