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
HTTP 200 OK
(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
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <PAT or admin SAT> |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
memory_store_id | string | Yes | Memory Store ID (memstore_...). |
Example request
Example response
HTTP 200 OK
Response fields
| Field | Type | Description |
|---|---|---|
id | string | ID of the deleted Memory Store. |
type | string | Always memory_store_deleted. |
deleted | boolean | Whether the Store was deleted. |
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 | The caller cannot access the resource. |
| 404 | not_found_error | The Store does not exist or is not visible across users. |
| 409 | conflict_error | The Store is archived or is still mounted to an (identity, template) pair. |
| 500/502/503 | api_error | Forward or a dependent service failed. |