List memories in a space
Lists all memories within a given space. Pagination is supported via maxResults and nextToken (opaque). nextToken is a URL-safe Base64 string without padding; do not parse or construct it. This is a read-only operation with no side effects and is safe to retry. Requires LIST_MEMORY_OWN or LIST_MEMORY_ANY permission. Returns NOT_FOUND if the specified space does not exist.
In: header
Path Parameters
The unique identifier of the space containing the memories
Query Parameters
Whether to include the original content in the response (defaults to false). The snake_case alias include_content is also accepted.
falseWhether to include background job processing history in the response (defaults to false). The snake_case alias include_processing_history is also accepted.
falseFilter memories by processing status (PENDING, PROCESSING, COMPLETED, FAILED). The snake_case alias status_filter is also accepted.
"PENDING" | "PROCESSING" | "COMPLETED" | "FAILED"Optional metadata filter expression for list results See Filter Expressions reference for syntax and examples.
Maximum number of results per page (defaults to 50, clamped to [1, 500]). The snake_case alias max_results is also accepted.
50int32Opaque pagination token for the next page. URL-safe Base64 without padding; do not parse or construct it. The snake_case alias next_token is also accepted.
Field to sort by (e.g., 'created_at'). The snake_case alias sort_by is also accepted.
Sort direction (ASCENDING or DESCENDING). The snake_case alias sort_order is also accepted.
Response Body
curl -X GET "http://localhost:8080/v1/spaces/550e8400-e29b-41d4-a716-446655440000/memories?includeContent=false&includeProcessingHistory=false&statusFilter=COMPLETED&filter=val%28%27%24.source%27%29+%3D+%27email%27&maxResults=100&nextToken=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...&sortBy=created_at&sortOrder=DESCENDING"{
"memories": [
{
"memoryId": "550e8400-e29b-41d4-a716-446655440000",
"spaceId": "550e8400-e29b-41d4-a716-446655440001",
"contentType": "text/plain",
"processingStatus": "COMPLETED"
}
],
"nextToken": "eyJvZmZzZXQiOjEwLCJsaW1pdCI6MTB9"
}