Skip to navigation

Preview and permanently delete conversations in one environment and an inclusive UTC date range.

Requires one configured environment and both dates. Deletes matching conversations across all channels, recordings, local history, translations, captured events and cached analytics. Preview first, then confirm the exact returned IDs. Active or unresolved conversations are skipped and returned as skipped entries with id and reason in both preview and completion. Unverifiable environment ownership blocks deletion. A partial failure returns deleted IDs; refresh before retrying. Required permissions: workspace.manage, conversations.review.

Authentication

AuthorizationBearer

Kinde access token with the configured LogicDialog audience and workspace membership/permissions. Channel API keys cannot authenticate management operations.

Path parameters

workspaceIdstringRequired

Request

This endpoint expects an object.
environmentstringRequired

One configured environment key; all is not allowed.

fromdateRequired

Inclusive start date (UTC).

todateRequired

Inclusive end date (UTC).

confirmbooleanOptionalDefaults to false
Set true only after reviewing the returned IDs.
idslist of stringsOptional

Exact set of IDs returned by the preview; required with confirm=true.

Response

Preview count and IDs, or confirmed deletion result

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
409
Conflict Error