Reset Contact Memory

Permanently delete all memory for a contact scoped to a specific persona or agent number. All conversation history, facts, summaries, and entities for that pair are removed. This cannot be undone.

POST /v1/memory/reset

Reset Memory

cURL

curl --request POST \
  --url https://api.bland.ai/v1/memory/reset \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "contact_id": "<string>",
  "persona_id": "<string>",
  "agent_number": "<string>"
}
'

Response

{
  "data": {
    "success": true
  },
  "errors": null
}

This action is irreversible. All memory data (recent messages, summary, facts, entities) for this contact/persona pair will be permanently deleted.

Headers

authorization · string · required

Your API key for authentication.

Body Parameters

contact_id · string · required

The unique identifier of the contact whose memory should be reset.

persona_id · string

The persona ID for memory scoping. Either persona_id or agent_number is required.

agent_number · string

The agent phone number for memory scoping. Either persona_id or agent_number is required.

Response

data · object

Success confirmation.

data.success · boolean

Whether the reset was successful.

errors · null

Error array (null on success).

Response

{
  "data": {
    "success": true
  },
  "errors": null
}