ai.v1.AssistantService
ListMemories
ListMemories lists what the assistant remembers about the caller, newest first. Each memory carries its kind: a PROFILE memory applies to every answer, the others are used when relevant to a message. Errors: - INVALID_ARGUMENT: malformed request or page token. - UNAVAILABLE: SERVICE_UNAVAILABLE; retry later. - UNAUTHENTICATED: missing or invalid credentials.
Request
curl --request POST \ \
--url 'https://api.testnet.polyester.com/ai.v1.AssistantService/ListMemories' \
--header 'Content-Type: application/json' \
--header 'Connect-Protocol-Version: 1' \
--data '{
"limit": 100,
"pageToken": "eyJvZmZzZXQiOjEwMH0"
}'Responses
{
"memories": [
{
"conversationId": "1",
"createdAt": "2025-01-01T00:00:00Z",
"kind": "FACT",
"memoryId": "1",
"text": "value"
}
],
"nextPageToken": "eyJvZmZzZXQiOjIwMH0"
}ai.v1.ListMemoriesRequestai.v1.ListMemoriesResponseMaximum memories to return. 0 means the default of 50; maximum 200.
Opaque, keyset-backed, exclusive cursor from a previous response. Bound to the caller, created_at and memory_id.
Public memory ID.
The remembered fact, in plain text.
When the fact was remembered.
The conversation the fact was learned in. Omitted when that conversation is unknown.
What kind of fact the memory holds.
Cursor for the next page. Empty when no more results exist.
| Key | HTTP status | Connect code | Error | When |
|---|---|---|---|---|
| unauthenticated | 401 | unauthenticated | Unauthenticated | Authentication required. |
| permission-denied | 403 | permission_denied | Permission Denied | Permission denied. |
| invalid-argument | 400 | invalid_argument | Invalid Argument | Invalid argument. |
| not-found | 404 | not_found | Not Found | Not found. |
| unavailable | 503 | unavailable | Unavailable | Service unavailable. |