List Memory versions

Lists version snapshots in a Memory Store. Versions are organized at the Store level. Use memory_id to filter for the history of one Memory. Creating, updating, or deleting a Memory automatically produces an immutable version. The list response does not include content. Use Get a Memory version to retrieve version content.

Path

GET /api/v1/forward/memory_stores/{memory_store_id}/memory_versions

Headers

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

Path parameters

Parameter	Type	Required	Description
`memory_store_id`	string	Yes	Memory Store ID (`memstore_...`).

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`.
`memory_id`	string	No	Returns only versions of this Memory (`mem_...`).

Example requests

# All versions in a Store
curl -X GET "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd/memory_versions" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

# Version history of one Memory
curl -X GET "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd/memory_versions?memory_id=mem_00mc7mvag5u68kkfvxhy" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

Example response

HTTP 200 OK

{
  "data": [
    {
      "id": "memver_00mc7mw0t337kbcx5q52",
      "type": "memory_version",
      "memory_store_id": "memstore_00mc7mukn7lkxr454tjd",
      "memory_id": "mem_00mc7mvag5u68kkfvxhy",
      "path": "decisions/arch-choice.md",
      "content_size_bytes": 108,
      "content_sha256": "9a4f8d2c1b7e6543210fedcba9876543210fedcba9876543210fedcba987654",
      "operation": "updated",
      "redacted": false,
      "redacted_at": null,
      "created_at": "2026-08-14T11:00:00Z"
    },
    {
      "id": "memver_00mc7mvag5u68lh2y8gwh",
      "type": "memory_version",
      "memory_store_id": "memstore_00mc7mukn7lkxr454tjd",
      "memory_id": "mem_00mc7mvag5u68kkfvxhy",
      "path": "decisions/arch-choice.md",
      "content_size_bytes": 99,
      "content_sha256": "1712de0d497a5aeef2beeccf4fbb7d5a16944975438d0c25447b9c1fba13099a",
      "operation": "created",
      "redacted": false,
      "redacted_at": null,
      "created_at": "2026-08-14T10:00:00Z"
    }
  ],
  "first_id": "memver_00mc7mw0t337kbcx5q52",
  "last_id": "memver_00mc7mvag5u68lh2y8gwh",
  "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 Version objects, without `content`.
`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.
404	`not_found_error`	The Memory Store does not exist or is not visible across users.
500/502/503	`api_error`	Forward or a dependent service failed.

​Path

​Headers

​Path parameters

​Query parameters

​Example requests

​Example response

​Empty-list response

​Response fields

​Errors