Skip to main content
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:

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

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspaceId
string
required

Workspace ID.

Example:

"workspace_01HXKD2E5NQM3T9AYWCF133E3Q"

id
string
required

Session ID. Accepts the canonical wsess_… form or the external_id:<value> form.

Response