Skip to main content
GET /v1/memory_stores/{memory_store_id}/memories Retrieves active memory entries in the specified Memory Store. List responses do not include content.

​
Path parameters

ParameterTypeRequiredDescription
memory_store_idstringYesMemory Store ID with the memstore_ prefix

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer $QODER_PAT

​
Query parameters

ParameterTypeRequiredDescription
limitintegerNoMaximum number of records per page. Must be positive; defaults to 20 and is capped at 100
after_idstringNoCursor pagination: return records after this ID. Mutually exclusive with before_id
before_idstringNoCursor pagination: return records before this ID. Mutually exclusive with after_id
path_prefixstringNoReturn only entries whose path starts with this prefix
created_at[gte]stringNoReturn records created at or after this RFC 3339 timestamp
created_at[lte]stringNoReturn records created at or before this RFC 3339 timestamp

​
Example request

curl -X GET "https://api.qoder.com/api/v1/cloud/memory_stores/memstore_xxx/memories" \
  -H "Authorization: Bearer $QODER_PAT"

# Paginate
curl -X GET "https://api.qoder.com/api/v1/cloud/memory_stores/memstore_xxx/memories?limit=20&after_id=mem_xxx" \
  -H "Authorization: Bearer $QODER_PAT"

# Filter by path prefix
curl -X GET "https://api.qoder.com/api/v1/cloud/memory_stores/memstore_xxx/memories?path_prefix=notes/" \
  -H "Authorization: Bearer $QODER_PAT"

​
Example response

HTTP 200 OK 
{
  "data": [
    {
      "id": "mem_019e3bb965a671fca51bde1cf8d87de0",
      "type": "memory",
      "store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
      "path": "test/note.md",
      "size": 11,
      "content_sha256": "64ec88ca00b268e5ba1a35678a1b5316d212f4f366b2477232534a8aeca37f3c",
      "version": 1,
      "metadata": {},
      "created_at": "2026-05-18T15:34:26.494349Z",
      "updated_at": "2026-05-18T15:34:26.494349Z"
    }
  ],
  "first_id": "mem_019e3bb965a671fca51bde1cf8d87de0",
  "last_id": "mem_019e3bb965a671fca51bde1cf8d87de0",
  "has_more": false
}

​
Response fields

FieldTypeDescription
dataarrayArray of Memory entry objects. content is omitted
first_idstring | nullID of the first record on the current page; null when data is empty
last_idstring | nullID of the last record on the current page; null when data is empty
has_morebooleanWhether more records are available

​
Pagination

Memory entry lists are returned by descending resource ID. Use after_id=<last_id> to fetch the next page when has_more is true.

​
Errors

HTTPTypeTrigger
400invalid_request_errorInvalid limit, invalid timestamp, or both before_id and after_id are provided
401authentication_errorMissing or invalid authentication token
404not_found_errorMemory Store does not exist
See Errors for the full error envelope.

Build persistent memory

Give your agent persistent memory across sessions.