Skip to main content
DELETE
Delete a memory by external ID

Authorizations

Authorization
string
header
required

A scoped Integration key, prefixed cint_. Send as Authorization: Bearer cint_... on every request. Server-side only. Legacy personal cmem_... keys remain accepted during migration; team/org-scoped cmem_... keys are not valid on this API.

Headers

Idempotency-Key
string

Optional stable source-event key.

Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{0,199}$

Path Parameters

externalId
string
required

Stable ID of this record in the source system. Stable record ID inside the named source.

Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$
Example:

"profile_123"

Body

application/json
endUserId
string
required

Your stable internal user ID. No colon allowed.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9@._-]{1,128}$
Example:

"u_123"

source
string
required

Stable source-system name, such as caeros-profile or conversation.

Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$
Example:

"caeros-profile"

version
integer
required
Required range: x >= 1
occurredAt
string<date-time>
required

Response

Tombstone applied or already existed.

record
object
required
success
boolean
receipt
object

The durable receipt of the record's LAST applied mutation — a projection of the record row (there is no per-version receipt history; persist receipts client-side if you need an audit trail).