# PATCH /phone/numbers/:id

**Resource:** [Phone](./phone.md)  
**Scopes:** `phone:write`  
**Write operation:** yes

Update phone number settings. Settable fields: friendly_name, transfer_number, inbound_voice_agent_config_id (voice_agent_config UUID or null), outbound_voice_agent_config_id (voice_agent_config UUID or null). When either agent assignment field is included, the API immediately pushes the change to Retell and returns retell_last_synced_at / retell_last_sync_error. Retell sync failure does NOT roll back the DB write.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `id` | path | uuid | yes | Phone number ID |
| `friendly_name` | body | string | no | Display name |
| `transfer_number` | body | string | no | Call forwarding number in E.164 format |
| `inbound_voice_agent_config_id` | body | string|null | no | voice_agent_config UUID for answering inbound calls. Pass null to clear. |
| `outbound_voice_agent_config_id` | body | string|null | no | voice_agent_config UUID for outbound caller ID. Pass null to clear. |

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`