Skip to main content

List Memory Store mounts for an Identity

List Memory Store mounts for an Identity and Template.

Lists active Memory Store mounts for an (identity, template) pair with pagination, including the existing system-managed default Store. The default Store is always first. Explicit mounts follow in ascending order of mount time and Store ID, with each Store returned only once. access reports each mount’s current permission. Without pagination parameters, the first 20 records are returned. Use has_more and cursors to retrieve further pages.

Path

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

Headers

HeaderRequiredDescription
AuthorizationYesBearer <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

ParameterTypeRequiredDescription
identity_idstringYesIdentity ID (idn_...).
template_idstringYesTemplate ID (tmpl_...).

Query parameters

ParameterTypeRequiredDescription
limitintegerNoMaximum records per page: 1–100, default 20.
after_idstringNoForward cursor: use the previous page’s last_id (Store ID).
before_idstringNoBackward cursor: use the current page’s first_id (Store ID). Mutually exclusive with after_id.

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

Returns an empty list when there are no valid mounts.
{
  "data": [],
  "first_id": null,
  "last_id": null,
  "has_more": false
}

Response fields

FieldTypeDescription
dataarrayArray of Memory Store mount objects.
first_idstring/nullmemory_store_id of the first mount on the current page.
last_idstring/nullmemory_store_id of the last mount on the current page.
has_morebooleanWhether more records exist in the requested pagination direction.

Errors

HTTPTypeTrigger
400invalid_request_errorInvalid path or pagination parameters, or both after_id and before_id were supplied.
401authentication_errorThe authentication token is missing or invalid.
403permission_errorAn Identity-level SAT tried to query another Identity.
404not_found_errorThe Identity or Template does not exist or is not visible, or the cursor is not a valid mount in the current scope.
500/502/503api_errorForward or a dependent service failed.