Skip to main content
GET /v1/memory_stores Retrieves Memory Stores under the current account. Archived stores are excluded by default.

​
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
include_archivedbooleanNoSet to true to include archived Memory Stores
namestringNoCase-insensitive prefix search on store name
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

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

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

# Search by name and include archived stores
curl -X GET "https://api.qoder.com/api/v1/cloud/memory_stores?name=docs&include_archived=true" \
  -H "Authorization: Bearer $QODER_PAT"

​
Example response

HTTP 200 OK 
{
  "data": [
    {
      "id": "memstore_019e3bb8d50674d9b082b73709c29c87",
      "type": "memory_store",
      "name": "doc-test-store",
      "description": "Test store",
      "status": "active",
      "entry_count": 0,
      "total_size": 0,
      "metadata": {},
      "created_at": "2026-05-18T15:33:49.449264Z",
      "updated_at": "2026-05-18T15:33:49.449264Z"
    }
  ],
  "first_id": "memstore_019e3bb8d50674d9b082b73709c29c87",
  "last_id": "memstore_019e3bb8d50674d9b082b73709c29c87",
  "has_more": false
}

​
Response fields

FieldTypeDescription
dataarrayArray of Memory Store objects
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 Store lists are returned by descending resource ID. To page through stores:
  1. Make the first request with limit to fetch the first page.
  2. If has_more is true, use after_id=<last_id> to fetch the next page.
  3. Use before_id=<first_id> to page backward.

​
Errors

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

Build persistent memory

Give your agent persistent memory across sessions.