JavaScript
Widget Sessions
Delete a widget session
Remove one session row and its secrets. Conversations are disassociated, not deleted.
DELETE
JavaScript
Removes a session and its secrets. Any tokens it minted stop working, same as a revoke, but the row itself goes away too.
Conversations survive, disassociated
Deleting a session does not delete the conversations it created. They stay in the workspace as objectives; they lose their link to the deleted session. If the goal is erasure (a GDPR request, an offboarded customer) that is not enough, and the tenant-level delete is the endpoint that takes the conversations with it. Pick by intent:Related
Delete a tenant's sessions
The erasure version, conversations included.
Revoke a widget session
End access but keep the record.
List widget sessions
What remains after the cleanup.
Erase a tenant
The full-tenant erasure, beyond sessions.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Workspace ID.
Example:
"workspace_01HXKD2E5NQM3T9AYWCF133E3Q"
Session ID. Accepts the canonical wsess_… form or the external_id:<value> form.