Skip to main content

Detach a Memory Store from an Identity

Detach a Memory Store from an Identity and Template.

Removes the mount between a Memory Store and an (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

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

ParameterTypeRequiredDescription
identity_idstringYesIdentity ID (idn_...).
template_idstringYesTemplate ID (tmpl_...).
memory_store_idstringYesID 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

FieldTypeDescription
idstringID of the detached Memory Store.
typestringAlways memory_store_binding_deleted. Unlike memory_store_deleted returned when deleting a Store, this endpoint only removes the mount and leaves the Store intact.
deletedbooleanWhether the mount was removed.

Errors

HTTPTypeTrigger
400invalid_request_errorA path parameter is invalid.
401authentication_errorThe authentication token is missing or invalid.
403permission_errorAn Identity-level SAT tried to operate on another Identity.
404not_found_errorThe Identity or Template does not exist, or the Store has no valid mount for this (identity, template) pair.
500/502/503api_errorForward or a dependent service failed.