JavaScript
Widget Sessions
Delete all of a tenant's widget sessions
The erasure endpoint. Every session for a tenant, across all widgets, and every conversation they created.
DELETE
JavaScript
Built for GDPR erasure requests. One call deletes every session belonging to a tenant across all widgets in the workspace, along with the conversations those sessions created. The response reports both counts.
An empty or missing
tenantId is required, and that is the safety
An empty or missing tenantId is rejected rather than matching everything. There is no “delete all sessions in the workspace” spelling of this endpoint, so a bug in your parameter plumbing turns into a 400, not a workspace-wide purge.
The tenant accepts the canonical tenant_… form or external_id:<value>, which is usually the natural one here: the erasure request arrives with your identifier for the customer, not Cadenya’s.
This deletes conversations. The single delete does not.
The single-session delete disassociates conversations and leaves them. This endpoint deletes them, because “erase this customer” means the content too.objectivesDeleted is your receipt for the erasure record.
The tenant record itself survives, empty. To remove that too, finish with erase a tenant.
Related
Erase a tenant
Remove the tenant record after its data.
List widget sessions
?tenantId= shows what this call takes with it.Delete a widget session
One row, conversations kept.
List tenants
Resolve your customer identifier to a tenant.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Workspace ID.
Example:
"workspace_01HXKD2E5NQM3T9AYWCF133E3Q"
Query Parameters
Tenant whose sessions to delete. Required — an empty value is rejected
rather than matching everything. Accepts the canonical tenant_… form or
the external_id:<value> form.