talkvalue path person update

Patch any combination of fields on a person record. Only the flags you pass are written. Omitted fields stay untouched. Pass --remove-company to detach the current company. Pass --company-id or --company-name to reassign.

Synopsis

talkvalue path person update <id> [options]

Arguments

Argument	Type	Description
`<id>`	integer	Person ID to update.

Options

Flag	Type	Description
`--first-name <name>`	string	Replace the first name.
`--last-name <name>`	string	Replace the last name.
`--primary-email <email>`	string	Set the primary email. TalkValue adds the address to the person’s email list when it is new.
`--email <email>`	string (repeatable)	Replace the email list. Repeat for each address.
`--primary-phone <phone>`	string	Set the primary phone.
`--phone <phone>`	string (repeatable)	Replace the phone list. Repeat for each number.
`--job-title <title>`	string	Replace the job title.
`--address <address>`	string	Replace the address.
`--avatar-url <url>`	string	Replace the avatar URL.
`--linkedin-url <url>`	string	Replace the LinkedIn URL.
`--x-url <url>`	string	Replace the X (formerly Twitter) URL.
`--company-name <name>`	string	Assign or rename the company by display name.
`--company-id <id>`	integer	Assign the company by ID.
`--remove-company`	flag	Detach the current company. Takes precedence over `--company-name` and `--company-id`.

Examples

1. Update a single field

talkvalue path person update 142 --job-title "Head of Growth"

Prints the updated record as a table. Only jobTitle changes server-side.

2. Replace the email list and set the primary

talkvalue path person update 142 \
  --email "alice@acme.com" \
  --email "alice.kim@personal.com" \
  --primary-email "alice@acme.com" \
  --json

Replaces the full email list and sets the primary in one call.

3. Detach a company in a script

talkvalue path person update 142 --remove-company --json \
  | jq -e '.data.company == null'

jq -e exits non-zero if the assertion fails, so the script halts when the detach did not take effect.

Response

The full updated record comes back, matching the shape of person get:

{
  "data": {
    "id": 142,
    "name": "Alice Kim",
    "primaryEmail": { "email": "alice@acme.com", "type": "WORK", "domain": "acme.com" },
    "emails": [
      { "email": "alice@acme.com", "type": "WORK", "domain": "acme.com" }
    ],
    "primaryPhone": "+1-415-555-0199",
    "company": { "id": 88, "displayName": "Acme Inc.", "domain": "acme.com", "nameUpdatable": false },
    "jobTitle": "Head of Growth",
    "channels": [/* … */],
    "events": [/* … */],
    "mergeOperations": [],
    "createdAt": "2026-04-12T00:00:00Z"
  }
}

Troubleshooting

The email already belongs to another person. When an address you pass to --primary-email or --email sits on another record in the workspace, the command exits non-zero and names the conflicting person in the error payload. Consolidate the two records with person merge first.
--remove-company takes precedence. When you pass --remove-company together with --company-id or --company-name, TalkValue detaches the company and ignores the assignment. Pass one or the other per call.

See Exit codes for the full mapping.

Get Started

Global

Commands

Recipes

AI Agents

Reference

talkvalue path person update

Synopsis

Arguments

Options

Examples

1. Update a single field

2. Replace the email list and set the primary

3. Detach a company in a script

Response

Troubleshooting

See also

​Synopsis

​Arguments

​Options

​Examples

​1. Update a single field

​2. Replace the email list and set the primary

​3. Detach a company in a script

​Response

​Troubleshooting

​See also

Synopsis

Arguments

Options

Examples

1. Update a single field

2. Replace the email list and set the primary

3. Detach a company in a script

Response

Troubleshooting

See also