Delete Memories by Caller
Delete every memory ever extracted for a specific caller on
this agent, addressed by `caller_identity`. Privacy / GDPR
surface. Rows become permanently unreachable immediately and are
hard-deleted by the retention job after the tenant's configured
retention window.
Returns `200` with the soft-deleted row count rather than a
bodiless `204`: the count is GDPR-purge audit evidence, so a
privacy operator has direct proof of the purge without
re-querying. This is a deliberate exception to the
delete-returns-204 convention, shared with the caller-purge
cascade (`DELETE /v1/agents/callers/{caller_id}`).
Authentication
AuthorizationBearer
Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.
Path parameters
agent_id
Headers
Speechify-Version
Query parameters
caller_identity
Stable caller identity whose memories on this agent are purged.
Response
Deletion summary (GDPR audit evidence).
deleted
Number of memories soft-deleted.
Errors
400
Bad Request Error
401
Unauthorized Error