SmartMemory
DELETE
/memory/{item_id}

Delete a memory item by ID with optional entity garbage collection.

Requires authentication and validates item ownership.

Args: item_id: ID of the memory item to delete cleanup_orphans: If True, also delete entities that have no other references (default: True)

Returns: dict: Deletion status and garbage collection statistics

Authorization

AuthorizationBearer <token>

Send Authorization: Bearer <token>. The token is either a Clerk session JWT or a SmartMemory API key (prefix sm_live_, sm_test_, or legacy sk_).

In: header

Path Parameters

item_id*Item Id

Query Parameters

cleanup_orphans?Cleanup Orphans

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/memory/string"
{}
{
  "detail": {
    "code": "invalid_scoped_validity",
    "message": "string",
    "retryable": false
  }
}
{
  "detail": {
    "code": "invalid_scoped_validity",
    "message": "string",
    "retryable": false
  }
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}
{
  "detail": {
    "code": "invalid_scoped_validity",
    "message": "string",
    "retryable": false
  }
}