remove_phone
Remove a phone number from the account. Always requires one code: start_2fa_for_action with action_type phone_remove and targets [this phone id]. Revokes every proof of the number and your own consents naming it, declines pending confirmations waiting on it, flags approval setups left with no approver, deletes the record and its messenger links, signs out your other devices, and names the new primary phone — your Proof of Me circles then reach you there. Refused for the number you signed in with, for your only way to sign in, and for your last phone while circles are active (circles_need_phone: add another phone first, or archive the circles). Cannot be undone.
ACCESS: needs a Proof account. Authenticate this client (Claude Code: /mcp → Authenticate), or sign in with start_login — a session opens this tool — then call this tool again.
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": {
"id": "<id>"
},
"name": "remove_phone"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Phone record ID |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | ||
| notice | No | ||
| success | No | Always `true`. The 1.x Go, PHP and Python SDK types carry it as a string, as released; it is typed boolean in the next major. | |
| identifier | No | Masked. | |
| removed_id | No | ||
| new_primary | No | The row that becomes (or became) primary when the removed one was; null otherwise. | |
| proofs_revoked | No | ||
| lookalike_watch | No | ||
| circles_repointed | No | Phones only: circles that now reach the owner at `new_primary`; 0 for an email. | |
| sessions_signed_out | No | Every other device was signed out, idle ones included; the calling session stays. False when that could not be done — the removal itself still happened. | |
| sessions_invalidated | No | Other listed devices signed out, idle ones included; the calling session stays. A device missing from the list — signed in before the list held idle devices, or one whose listing could not be recorded — is not counted, so read `sessions_signed_out` for whether every other device was signed out. | |
| authorizations_revoked | No | ||
| hitl_configs_without_approver | No |