List Memory Store mounts for an Identity

Lists all active Memory Store mounts for an (identity, template) pair, including the default Store created automatically when the first Session is created. The system-managed default Store is always first and is the only mount with access=read_write. Explicit mounts follow in ascending mount-time order and all use read_only. The number of mounts is limited to 10 explicit mounts plus the default slot. This endpoint therefore does not accept pagination parameters, and has_more is always false.

Path

GET /api/v1/forward/identities/{identity_id}/templates/{template_id}/memory_stores

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <PAT, admin SAT, or SAT for this Identity>`

An Identity-level Service Account Token can only query its own Identity. Querying another Identity returns 403.

Path parameters

Parameter	Type	Required	Description
`identity_id`	string	Yes	Identity ID (`idn_...`).
`template_id`	string	Yes	Template ID (`tmpl_...`).

Example request

curl -X GET "https://api.qoder.com/api/v1/forward/identities/idn_63ee28747a35cff93771c491/templates/tmpl_eb3377fb74ad413e17b3d755/memory_stores" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

Example response

HTTP 200 OK

{
  "data": [
    {
      "memory_store_id": "memstore_00mc7mtpughs0h0b7vll",
      "identity_id": "idn_63ee28747a35cff93771c491",
      "template_id": "tmpl_eb3377fb74ad413e17b3d755",
      "access": "read_write",
      "system_managed": true,
      "name": "System Default Memory",
      "status": "active",
      "entry_count": 3,
      "created_at": "2026-08-14T09:50:14Z"
    },
    {
      "memory_store_id": "memstore_00mc7mukn7lkxr454tjd",
      "identity_id": "idn_63ee28747a35cff93771c491",
      "template_id": "tmpl_eb3377fb74ad413e17b3d755",
      "access": "read_only",
      "system_managed": false,
      "name": "team-a",
      "status": "active",
      "entry_count": 12,
      "created_at": "2026-08-14T10:00:00Z"
    }
  ],
  "first_id": "memstore_00mc7mtpughs0h0b7vll",
  "last_id": "memstore_00mc7mukn7lkxr454tjd",
  "has_more": false
}

Empty-list response

If no Session has been created and no explicit Store is mounted, the endpoint returns an empty list. The system-managed default Store is created automatically when the first Session is created.

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

Response fields

Field	Type	Description
`data`	array	Array of Memory Store mount objects.
`first_id`	string/null	`memory_store_id` of the first mount on the current page.
`last_id`	string/null	`memory_store_id` of the last mount on the current page.
`has_more`	boolean	Always `false` because the mount count is limited.

Errors

HTTP	Type	Trigger
400	`invalid_request_error`	A path parameter is invalid.
401	`authentication_error`	The authentication token is missing or invalid.
403	`permission_error`	An Identity-level SAT tried to query another Identity.
404	`not_found_error`	The Identity or Template does not exist or is not visible.
500/502/503	`api_error`	Forward or a dependent service failed.

​Path

​Headers

​Path parameters

​Example request

​Example response

​Empty-list response

​Response fields

​Errors