preview_phone_removal
Read-only
Preview what removing a phone would do without changing anything, showing the counts the dashboard Remove dialog displays or the reason a removal would be refused. Requires a signed-in session.
Instructions
Preview what remove_phone would do to one phone, without changing anything: the counts the dashboard Remove dialog shows, or the reason removal would be refused. Needs a signed-in session, like remove_phone.
ACCESS: needs a Proof account, signed in: call start_login, show the user its challenge, then wait_for_login, then call this tool again. An API key alone does NOT open this tool.
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": "preview_phone_removal"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Phone record ID (24 hex characters) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | ||
| proofs | No | Active proofs of this identifier that would be revoked. | |
| allowed | No | False when a guard refuses the removal; the dialog shows `blocked.message` in its disabled state. | |
| blocked | No | ||
| circles | No | Phones only: active Proof of Me circles, which follow the primary phone. | |
| notice_to | No | Where the notice would go — captured before the row is gone. | |
| identifier | No | Masked. | |
| is_primary | No | ||
| new_primary | No | The row that becomes (or became) primary when the removed one was; null otherwise. | |
| authorizations | No | Approval consents naming it that would be revoked. | |
| lookalike_watch | No | Emails only: what happens to the Lookalike Watch notification address. | |
| hitl_configs_without_approver | No | Approval setups whose only approver channel this is; their pending requests would be declined. |