Detach a Memory Store from an Identity and Template.
Removes the mount between a Memory Store and an
An Identity-level Service Account Token can only operate on its own Identity. Operating on another Identity returns
HTTP 200 OK
(identity, template) pair. New Sessions for this pair no longer mount the Store. Existing Sessions, the Store itself, and its Memory entries are unaffected.
Detaching the default Store also disables automatic default Store creation for the current (identity, template). Detaching an explicit mount does not change the automatic-creation policy.
Path
DELETE /api/v1/forward/identities/{identity_id}/templates/{template_id}/memory_stores/{memory_store_id}
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_...). |
memory_store_id | string | Yes | ID of the Memory Store to detach (memstore_...). |
Example request
Example response
HTTP 200 OK
Response fields
| Field | Type | Description |
|---|---|---|
id | string | ID of the detached Memory Store. |
type | string | Always memory_store_binding_deleted. Unlike memory_store_deleted returned when deleting a Store, this endpoint only removes the mount and leaves the Store intact. |
deleted | boolean | Whether the mount was removed. |
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 operate on another Identity. |
| 404 | not_found_error | The Identity or Template does not exist, or the Store has no valid mount for this (identity, template) pair. |
| 500/502/503 | api_error | Forward or a dependent service failed. |