update_person_channel
Idempotent
Update a contact channel for a person. Identify the channel by ID or provider+value, then optionally change the provider or value.
Instructions
Update one contact channel on a person. Person accepts person ID, exact email, or exact display name. Identify the channel with exactly one locator: channelId, or provider plus value. Provide newProvider, newValue, or both. Updating to an existing provider+value on the same person fails with a conflict.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| channelId | No | a string that will be trimmed | |
| provider | No | Channel provider label: email, phone, linkedin, twitter, github, facebook, telegram, homepage, whatsapp, skype, profile, viber. | |
| value | No | a string that will be trimmed | |
| person | Yes | a string that will be trimmed | |
| newProvider | No | Channel provider label: email, phone, linkedin, twitter, github, facebook, telegram, homepage, whatsapp, skype, profile, viber. | |
| newValue | No | a string that will be trimmed |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | The successful tool result. The same value is also serialized as JSON in the text content for clients that do not read structuredContent. | |
| warnings | No | Optional agent-visible warnings about degraded result fidelity. Omitted when the server returned the documented happy-path payload. |