Delete User Memory

Permanently remove a specific user memory from storage.

This endpoint allows you to delete a user memory by its unique identifier. Once deleted, the memory cannot be recovered, so use this operation carefully.

The memory will be removed from your tenant’s storage and will no longer appear in search results or memory listings.

Hit the Try it button to try this API now in our playground. It’s the best way to check the full request and response in one place, customize your parameters, and generate ready-to-use code snippets.

Examples

API Request

curl --request DELETE \
  --url 'https://api.usecortex.ai/user_memory/delete_user_memory?tenant_id=tenant_1234&memory_id=memory_1234&sub_tenant_id=sub_tenant_4567' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Overview

The Delete User Memory endpoint allows you to remove specific memories from a user’s memory profile. This is useful for maintaining data quality, removing outdated information, or giving users control over their stored personal data.

Functionality

• Targeted Deletion: Removes a specific memory using its unique memory ID
• User Context Validation: Ensures the memory belongs to the authenticated user
• Immediate Removal: Permanently deletes the memory from the vector store
• Confirmation Response: Returns clear success/failure status for the deletion operation
• Tenant Isolation: Operates within the specified tenant/sub-tenant context

Use Cases

• Data Cleanup: Remove outdated or incorrect memories
• Privacy Compliance: Allow users to delete their personal data
• Memory Management: Maintain high-quality memory profiles by removing irrelevant information
• Error Correction: Delete memories that were added incorrectly
• User Control: Give users the ability to manage their own memory data

Finding Memory IDs

To delete a memory, you first need to find its ID using the List User Memories endpoint:

# First, list all memories to find the ID
curl -X GET "https://api.cortex.com/user_memory/list_user_memories?tenant_id=company_123&sub_tenant_id=marketing_team" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response will include source_id for each memory
{
  "success": true,
  "user_memories": [
    {
      "source_id": "mem_001_abc123",  # This is the memory_id to use
      "source_content": "User prefers detailed technical explanations..."
    }
  ]
}

# Then delete using the source_id
curl -X DELETE "https://api.cortex.com/user_memory/delete_user_memory?tenant_id=company_123&sub_tenant_id=marketing_team&memory_id=mem_001_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Important Notes

Permanent Deletion: Once a memory is deleted, it cannot be recovered. Make sure you have the correct memory ID before proceeding with deletion.

Memory ID Source: Memory IDs (source_id) can be obtained from the List User Memories endpoint or from the response of Add User Memory and Generate User Memory endpoints.

Best Practices:

• Always verify the memory content before deletion using the List endpoint
• Consider implementing user confirmation for memory deletion
• Log deletion activities for audit purposes
• Provide users with a way to review their memories before deletion

Pro Tip: For bulk memory management, you can combine this API with the List API to create a memory management interface that allows users to review and selectively delete their memories.

Response Fields

Field	Type	Description
success	boolean	Indicates whether the operation was successful
user_memory_deleted	boolean	Confirms whether the specific memory was successfully deleted

Parameters

Parameter	Type	Required	Description
tenant_id	string	Yes	Primary organizational identifier
sub_tenant_id	string	Yes	Secondary organizational identifier
memory_id	string	Yes	Unique identifier of the memory to delete

Error Responses

All endpoints return consistent error responses following the standard format. For detailed error information, see our Error Responses documentation.

Authorizations

Authorization · string · header · required

Query Parameters

tenant_id · string · required

Example:

memory_id · string · required

Example:

sub_tenant_id · string · default: ""

Example:

Response

200

application/json

success · boolean · required

Example:

user_memory_deleted · boolean · required

Example: