Read Memories

Retrieve memory entries for a profile, filtered by category.

URI: /api/v1/agentic/memory

HTTP Method: GET

Authentication: Bearer JWT

Query Parameters

Parameter	Type	Required	Description
profile_id	String	Yes	Profile ID of the Individual or User.
profile_type	String	Yes	Type of profile. Values: `individual`, `employee`.
category	String	Yes	Partition key that filters the returned memory entries.

Request Headers

Header	Required	Description
Authorization	Yes	Bearer JWT token.

Response Body Schema

Field	Type	Description
memories	Array	The matching memory entries.
memories[].memoryId	String	Identifier of the memory entry.
memories[].content	String	Memory content.

Example Response

Status: 200 OK

1{
2  "memories": [
3    { "memoryId": "mem_abc123", "content": "Prefers EST scheduling" },
4    { "memoryId": "mem_def456", "content": "Allergic to peanuts" }
5  ]
6}

Error Codes

Status Code	Description
400	Bad Request. Invalid query parameters or missing required fields.
401	Unauthorized. Invalid or missing JWT token.
500	Internal Server Error.

DID THIS ARTICLE SOLVE YOUR ISSUE?
Let us know so we can improve!