Skip to main content
Memory Stores

Delete a Memory Store

Delete an unmounted Forward Memory Store.

Deletes an unmounted Memory Store together with all of its Memory entries and version history. Mounts are checked before deletion. If the Store is still mounted to any (identity, template) pair, the endpoint returns 409. Detach every mount before deleting the Store. Archived Stores cannot be deleted.

Path

DELETE /api/v1/forward/memory_stores/{memory_store_id}

Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT or admin SAT>

Path parameters

ParameterTypeRequiredDescription
memory_store_idstringYesMemory Store ID (memstore_...).

Example request

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

Example response

HTTP 200 OK
{
  "id": "memstore_00mc7mukn7lkxr454tjd",
  "type": "memory_store_deleted",
  "deleted": true
}

Response fields

FieldTypeDescription
idstringID of the deleted Memory Store.
typestringAlways memory_store_deleted.
deletedbooleanWhether the Store was deleted.

Errors

HTTPTypeTrigger
400invalid_request_errorA path parameter is invalid.
401authentication_errorThe authentication token is missing or invalid.
403permission_errorThe caller cannot access the resource.
404not_found_errorThe Store does not exist or is not visible across users.
409conflict_errorThe Store is archived or is still mounted to an (identity, template) pair.
500/502/503api_errorForward or a dependent service failed.