---
title: "Update a phone number"
method: PATCH
path: "/numbers/{phone_number_slug}"
tags: ["phoneNumbers"]
---

# Update a phone number

`PATCH /numbers/{phone_number_slug}`

Updates the configuration of a phone number.

## Path parameters

- `phone_number_slug` string, required

## Headers

- `Authorization` string, required

## Request body

- object
  - `friendly_name` string — A human-readable name for the phone number.
  - `sip_auth_username` string — SIP authentication username.
  - `sip_outbound_proxy` string — SIP outbound proxy.
  - `sip_term_uri` string — SIP termination URI / SIP domain. Required when changing the SIP domain for providers other than `five9`, `ringcx`, and `zoom`. You may also send `termination_uri` as an alias; it is mapped to `sip_term_uri`.
  - `termination_uri` string — Alias for `sip_term_uri` (SIP domain). Required when setting the domain for providers other than `five9`, `ringcx`, and `zoom`.
  - `provider_name` 'twilio' | 'telnyx' | 'vonage' | 'ring_central' | 'ringcx' | 'custom' | 'zoom' | 'five9' — Telephony provider. When set to a non-auto provider without a SIP domain, the request fails with 400.
  - `trunk_username` string — SIP trunk username for authentication. Required when enabling `uac_enabled`.
  - `trunk_pwd` string — SIP trunk password for authentication. Required when enabling `uac_enabled`.
  - `uac_enabled` boolean — When true, Synthflow sends outbound SIP REGISTER traffic to your carrier or PBX. Requires `trunk_username` and `trunk_pwd` when enabling registration.
  - `uac_register_expires` integer — SIP registration refresh interval in seconds. Whole numbers only, between 60 and 3600. Defaults to 300.

## Response `200`

200

- PhoneNumbersUpdatePhoneNumberResponse200
  - `status` string — Whether the request was successful.

## Other responses

- `400` — 400

---

[API](https://skmtc.net/synthflow/apis/platform-api.md) · [All operations](https://skmtc.net/synthflow/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synthflow/platform-api/versions/decb652b52e0/schema)