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
{
"memories": [
{ "memoryId": "mem_abc123", "content": "Prefers EST scheduling" },
{ "memoryId": "mem_def456", "content": "Allergic to peanuts" }
]
}
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. |