Update Contact (CRM write)
update_personMUTATES one owned Dayze contact by person_id. context_tags-only patches ok (full desired array; repeats are no-ops). last_interaction_at corrects last touch (owner-set). personal-write OAuth needs request_id (unique per write; reuse to retry). Omitted fields stay. undo_contact_change(change_id) reverts. Requires context.write; share tokens cannot write. ($0.10; API key required)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"person_id": "<person_id>"
},
"name": "update_person"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Rename contact (also refreshes URL slug). Prefer over create+merge for spelling fixes | |
| tier | No | Relationship priority. VIP stays in inner_circle even when not favorited | |
| No | email. Omit to leave unchanged; null or blank clears. | ||
| notes | No | Replaces people.notes (does not append). Empty or null clears | |
| phone | No | phone. Omit to leave unchanged; null or blank clears. | |
| gender | No | Null or blank clears | |
| address | No | Postal address (one line). Null or blank clears | |
| company | No | company. Omit to leave unchanged; null or blank clears. | |
| wallets | No | ENS (.eth) / SNS (.sol) names and/or addresses for this contact. Merged into social_handles (legacy ens/ens_address kept); empty array clears wallet keys only. | |
| birthday | No | YYYY, YYYY-MM, YYYY-MM-DD, or MM-DD / --MM-DD (year unknown; 02-29 ok). Null/empty clears | |
| pronouns | No | e.g. she/her. Null or blank clears | |
| first_met | No | When/how they first met (free text). Null or blank clears | |
| person_id | Yes | UUID of a person the authenticated user owns | |
| birth_time | No | HH:MM 24-hour. Null clears | |
| death_date | No | YYYY-MM-DD; marks the contact deceased. Null clears | |
| occupation | No | Occupation / job title. Omit to leave unchanged; null or blank clears. | |
| request_id | No | Required on personal-write OAuth. Unique for a new write; reuse for an exact retry. | |
| is_deceased | No | false also clears death_date and the memorial reminder | |
| is_favorite | No | Favorite flag. Favorites (and VIP) appear in get_context_pack inner_circle | |
| cadence_days | No | Check-in every N days; null or 0 turns check-ins off. Next check-in is recomputed | |
| context_tags | No | Contexts such as Work, Personal, Family, plus custom tags | |
| relationship | No | Relationship label (friend, sister, …). Empty or null clears | |
| relationships | No | Who they are to the user, primary-first (e.g. Friend + Client) | |
| idempotency_key | No | Alias for request_id. | |
| first_met_location | No | Where they first met. Null or blank clears | |
| sexual_orientation | No | Private. Null or blank clears | |
| expected_updated_at | No | Optional ISO updated_at you last read. Write applies only if unchanged; otherwise code "conflict" with the current record and changes nothing. | |
| last_interaction_at | No | Owner's correction of when they were last in touch (YYYY-MM-DD or ISO date-time with zone; not future). Newer activity still moves it forward. | |
| preserve_old_name_as_alias | No | When renaming, keep the previous name as a former_name alias (default true) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | Where the not_applied fields are changed instead (the Dayze profile). | |
| person | Yes | A Dayze person or contact record. | |
| account | No | The Dayze account this data belongs to. With more than one Dayze connection, name it in the answer. | |
| changed | Yes | Changed fields with before and after values. | |
| is_self | No | True when the person is the user's own card (Me). | |
| change_id | No | Pass to undo_contact_change to revert this change, birthday and birthday_precision included. | |
| provenance | No | Which connector wrote the record and which connected Dayze account received it. | |
| not_applied | No | ||
| former_name_alias | No | After a rename that keeps the old name (preserve_old_name_as_alias, default true): alias, saved, and reason when it could not be kept. | |
| life_state_rebuilt | Yes |