## Update a phone number

`client.phoneNumbers.update(stringphoneNumberID, PhoneNumberUpdateParamsbody, RequestOptionsoptions?): PhoneNumberUpdateResponse`

**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.

### Parameters

- `phoneNumberID: string`

- `body: PhoneNumberUpdateParams`

  - `forwarding_number: string | null`

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

### Returns

- `PhoneNumberUpdateResponse`

  - `id: string`

    Unique identifier for the phone number

  - `forwarding_number: string | null`

    The forwarding number after the update. Null when cleared.

  - `phone_number: string`

    Phone number in E.164 format

### Example

```typescript
import LinqAPIV3 from '@linqapp/sdk';

const client = new LinqAPIV3({
  apiKey: process.env['LINQ_API_V3_API_KEY'], // This is the default and can be omitted
});

const phoneNumber = await client.phoneNumbers.update('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e', {
  forwarding_number: '+12025559999',
});

console.log(phoneNumber.id);
```

#### Response

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