Skip to main content
Remove a person from the active workspace. The CLI refuses to run without --confirm. There is no interactive prompt, so scripts have to opt in explicitly. Deletion is immediate. When the same primary email arrives again through import create, an integration sync, or a person added in the dashboard, TalkValue restores the record with its history intact.

Synopsis

Arguments

Options

Examples

1. Delete a single record

Prints { "deleted": true, "id": 142 } as a table on success. Re-running the command on a missing ID returns a 404 and a non-zero exit code.

2. Pipe to jq for a clean assertion

jq -e exits non-zero if deleted is anything but true, so the surrounding script fails closed.

3. Bulk delete from a file of IDs

Process one ID per line. Capture stderr to a log file if you need to inspect failures separately.

Response

The acknowledgement object is the only payload. The deleted person record itself is not returned. Read person activity on the ID before you delete when you want a copy of the timeline outside TalkValue.

See also

  • person merge. Prefer merge over delete when consolidating duplicates.
  • person activity. Review the full timeline before deleting.
  • person get. Confirm you have the right ID.
  • People. The dashboard surface this command mirrors.