List Memory Store mounts for an Identity and Template.
Lists active Memory Store mounts for an
An Identity-level Service Account Token can only query its own Identity. Querying another Identity returns
HTTP 200 OK
Returns an empty list when there are no valid mounts.
(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
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <PAT, admin SAT, or SAT for this Identity> |
403.
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
identity_id | string | Yes | Identity ID (idn_...). |
template_id | string | Yes | Template ID (tmpl_...). |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | No | Maximum records per page: 1–100, default 20. |
after_id | string | No | Forward cursor: use the previous page’s last_id (Store ID). |
before_id | string | No | Backward cursor: use the current page’s first_id (Store ID). Mutually exclusive with after_id. |
Example request
Example response
HTTP 200 OK
Empty-list response
Returns an empty list when there are no valid mounts.
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 | Whether more records exist in the requested pagination direction. |
Errors
| HTTP | Type | Trigger |
|---|---|---|
| 400 | invalid_request_error | Invalid path or pagination parameters, or both after_id and before_id were supplied. |
| 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, or the cursor is not a valid mount in the current scope. |
| 500/502/503 | api_error | Forward or a dependent service failed. |