Responses and visitors
erase_visitor
Permanently erase one visitor: identity, submissions scrub, interactions, worksheets, uploaded documents (rows + Storage objects). Requires `confirm: true` — pass true only after the human operator has agreed. GDPR erasure, cannot be undone. Unknown or cross-account visitors give E_NOT_FOUND.
Behaviour
- Effect
- Destructive. It can remove or overwrite existing data.
- Repeat calls
- Not idempotent. Repeating the call can produce a further change.
- Plan
- Available on every plan, including free.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| request_id | string | Yes | - |
| visitor_id | uuid | Yes | - |
| confirm | boolean | Yes | Set to true only after the human operator has agreed to permanently erase this visitor's identity, activity, submissions, worksheets, and uploaded documents. Passing false (or omitting) raises E_CONFIRM_REQUIRED, the intended machine-readable signal to stop and ask the human. |
Returns
| Name | Type |
|---|---|
| erased | true |
| visitor_id | uuid |
| documents_deleted | integer |
| storage_removed | integer |
| storage_failed_count | integer |
| idempotency_replay | false |
Using it
erase_visitor is called by an AI assistant connected to Sentway over MCP, not by hand. Point the assistant at the Sentway MCP endpoint and complete the OAuth flow, and the tool becomes available in the same session as the other 56 Sentway tools. See connecting over MCP.