GoodMem
ReferenceAPIREST APISpaces

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.

GET
/v1/spaces/{spaceId}/memories
x-api-key<token>

In: header

Path Parameters

spaceIdstring

The unique identifier of the space containing the memories

Query Parameters

includeContent?boolean

Whether to include the original content in the response (defaults to false)

statusFilter?string

Filter memories by processing status (PENDING, PROCESSING, COMPLETED, FAILED)

maxResults?integer

Maximum number of results per page (defaults to 50, clamped to [1, 500]).

Formatint32
nextToken?string

Opaque pagination token for the next page. URL-safe Base64 without padding; do not parse or construct it.

sortBy?string

Field to sort by (e.g., 'created_at')

sortOrder?string

Sort direction (ASCENDING or DESCENDING)

Response Body

curl -X GET "http://localhost:8080/v1/spaces/550e8400-e29b-41d4-a716-446655440000/memories?includeContent=false&statusFilter=COMPLETED&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"
}
Empty
Empty
Empty
Empty