> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magpipe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Memory

> Delete a caller's memory

Permanently delete a caller's memory. This removes all stored information about past conversations with this caller.

<Warning>
  This action is irreversible. The agent will treat future calls from this contact as new conversations.
</Warning>

## Request Body

<ParamField body="memory_id" type="string" required>
  UUID of the memory record to delete
</ParamField>

## Response

Returns a success confirmation.

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.magpipe.ai/functions/v1/delete-memory" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "memory_id": "789e0123-e89b-12d3-a456-426614174000"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true
  }
  ```

  ```json 404 theme={null}
  {
    "error": {
      "code": "not_found",
      "message": "Memory not found"
    }
  }
  ```
</ResponseExample>
