## Update a phone number

**put** `/v3/phone_numbers/{phoneNumberId}`

Updates the forwarding number for a phone number. The forwarding number is where inbound calls will be forwarded to.

Pass an empty string to clear the forwarding number.

### Path Parameters

- `phoneNumberId: string`

### Body Parameters

- `forwarding_number: string`

  The forwarding number in E.164 format. Set to null or empty string to clear.

### Returns

- `id: string`

  Unique identifier for the phone number

- `forwarding_number: string`

  The forwarding number after the update. Null when cleared.

- `phone_number: string`

  Phone number in E.164 format

### Example

```http
curl https://api.linqapp.com/api/partner/v3/phone_numbers/$PHONE_NUMBER_ID \
    -X PUT \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $LINQ_API_V3_API_KEY" \
    -d '{
          "forwarding_number": "+12025559999"
        }'
```

#### Response

```json
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "phone_number": "+12025551234",
  "forwarding_number": "+12025559999"
}
```