Skip to main content
DELETE
TypeScript
Send {"ids": [...]} to delete specific messages (soft, versioned). Send {"permanent": true} to delete the entire context (hard, irreversible).
Include metadata to record why this deletion was made. Optional, but recommended for audit trail.

Authorizations

Authorization
string
header
required

API key from your UltraContext dashboard

Path Parameters

id
string
required

Context ID (ctx_...)

Body

application/json

Optional. Omit to delete the entire context. Include ids to delete specific messages.

Either ids (soft-delete specific messages, versioned) or {permanent: true} (hard-delete entire context, irreversible). Any other body shape returns 400 to prevent typos from silently wiping a context.

ids
required

Single message ID (msg_...)

metadata
object

Audit metadata for this version (e.g., reason, ticket)

Response

Context deleted or messages deleted (new version created)

deleted
boolean

Whether the context was deleted

id
string

The deleted context ID

metadata
object

Audit metadata echoed from the request, if supplied