Visitor commands: forget, identify, merge
The Visitor Verbs forget, identify, merge as CLI commands, with inputs, result, refusals and an example.
Reference for Visitor, one group of Visitor commands.
Visitor.forget
Forget masks a person’s captured data across every Event and Recording and suppresses further capture, keeping the records. Verb page.
npx startup-builder do Visitor.forget --json '<input>' [--try | --send | --do]Emits Visitor.forgotten.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
visitor | Visitor | required | The Visitor to forget. |
request | text | required | The privacy request it answers. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
visitor | Visitor | required | The Visitor, masked. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation. | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
Example
npx startup-builder do Visitor.forget --json '{"visitor":Visitor.identify
Identify joins a Visitor to the Contact it turns out to be, so earlier Visits count toward that person. Verb page.
npx startup-builder do Visitor.identify --json '<input>' [--try | --send | --do]Emits Visitor.identified.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
visitor | Visitor | required | The Visitor. |
contact | Contact | required | The Contact or Customer the Visitor is. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
contact | Contact | required | The Contact, with the Visitor’s Visits attached. |
visitor | Visitor | required | The Visitor, now joined to its Contact. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation. | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
Example
npx startup-builder do Visitor.identify --json '{"visitor":Visitor.merge
Merge joins two Visitor ids that belong to one person and keeps both as aliases. Verb page.
npx startup-builder do Visitor.merge --json '<input>' [--try | --send | --do]Emits Visitor.merged.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
visitor | Visitor | required | The Visitor to merge. |
into | Visitor | required | The Visitor that remains. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
visitor | Visitor | required | The remaining Visitor. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation. | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
Example
npx startup-builder do Visitor.merge --json '{"visitor":