Detach a Memory Store from an Identity

Removes the mount between a Memory Store and an (identity, template) pair. The Store and its Memory entries are not affected. Sessions created later by the Identity with this Template no longer load the Store. A system-managed default Store cannot be detached. Attempting to detach it returns 409.

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>`

An Identity-level Service Account Token can only operate on its own Identity. Operating on another Identity returns 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

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

Example response

HTTP 200 OK

{
  "id": "memstore_00mc7mukn7lkxr454tjd",
  "type": "memory_store_binding_deleted",
  "deleted": true
}

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 is not mounted to this `(identity, template)` pair.
409	`conflict_error`	The target is the system-managed default Store and cannot be detached.
500/502/503	`api_error`	Forward or a dependent service failed.

​Path

​Headers

​Path parameters

​Example request

​Example response

​Response fields