Update an existing person. Only provide fields you want to change - all fields are optional.

Partial Updates:

• Only include fields you want to update
• Omitted fields will remain unchanged
• To clear a field, send null or empty string

Assignment:

• Send assignedUserId, assignedPondId, or assignedGroupId with a valid UUID to assign
• Only one assignment type may be provided at a time
• Send any assignment field as null or "" to clear/unassign the person
• Omit all assignment fields entirely to leave the current assignment unchanged

Tag Handling:

• Use mergeTags=true to add tags without removing existing ones
• Use mergeTags=false (or omit) to replace all tags
• For more control, use the dedicated tag endpoints: /people/{id}/tags/apply and /people/{id}/tags/delete

Email Handling:

• Use mergeEmails=true to add new emails and update existing ones without removing others
• Use mergeEmails=false (or omit) to replace all emails

Phone Handling:

• Use mergePhones=true to add new phones and update existing ones without removing others
• Use mergePhones=false (or omit) to replace all phones

Examples:

Update Name and Stage:

{
  "firstName": "Jane",
  "stage": "Qualified"
}

Add Tags (with mergeTags=true):

{
  "tags": ["buyer", "active"]
}

Replace All Tags (with mergeTags=false or omitted):

{
  "tags": ["archived"]
}