List Memory Stores

Returns the Memory Stores visible to the current account, ordered by ID in descending order with cursor pagination. The response includes the default Identity store created automatically when a Session is created (system_managed=true). This differs from the generic GET /api/v1/forward/resources?type=memory_store endpoint, which only returns stores explicitly created by users.

Path

GET /api/v1/forward/memory_stores

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <PAT or admin SAT>`

Query parameters

Parameter	Type	Required	Description
`limit`	integer	No	Maximum number of results per page, from 1 to 100. Default: 20.
`before_id`	string	No	Backward pagination cursor. Mutually exclusive with `after_id`.
`after_id`	string	No	Forward pagination cursor. Mutually exclusive with `before_id`.
`system_managed`	boolean	No	Three-state filter: `true` returns only system-managed default stores; `false` returns only user-created stores; omit it to return both.

Example requests

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

# Paginated list
curl -X GET "https://api.qoder.com/api/v1/forward/memory_stores?limit=10&after_id=memstore_xxx" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

# User-created stores only
curl -X GET "https://api.qoder.com/api/v1/forward/memory_stores?system_managed=false" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

Example response

HTTP 200 OK

{
  "data": [
    {
      "id": "memstore_00mc7mukn7lkxr454tjd",
      "type": "memory_store",
      "name": "project-alpha-memory",
      "description": "Agent knowledge base for project Alpha",
      "status": "active",
      "entry_count": 12,
      "total_size": 4096,
      "metadata": {"created_by": "forward", "team": "backend"},
      "system_managed": false,
      "identity_id": null,
      "created_at": "2026-08-14T10:00:00Z",
      "updated_at": "2026-08-14T10:00:00Z",
      "archived_at": null,
      "binding_info": {"identity_template_count": 1}
    }
  ],
  "first_id": "memstore_00mc7mukn7lkxr454tjd",
  "last_id": "memstore_00mc7mukn7lkxr454tjd",
  "has_more": false
}

Empty-list response

{
  "data": [],
  "first_id": null,
  "last_id": null,
  "has_more": false
}

Response fields

Field	Type	Description
`data`	array	Array of Memory Store objects.
`first_id`	string/null	ID of the first record on the current page.
`last_id`	string/null	ID of the last record on the current page.
`has_more`	boolean	Whether more records are available.

Errors

HTTP	Type	Trigger
400	`invalid_request_error`	`limit` is out of range, or `after_id` and `before_id` are both supplied.
401	`authentication_error`	The authentication token is missing or invalid.
403	`permission_error`	The caller cannot access the resource.
500/502/503	`api_error`	Forward or a dependent service failed.

​Path

​Headers

​Query parameters

​Example requests

​Example response

​Empty-list response

​Response fields

​Errors