---
title: "Updates the capabilities of a phone number."
method: PATCH
path: "/phoneNumbers/{phoneNumber}/capabilities"
tags: ["Manage purchased phone numbers"]
---

# Updates the capabilities of a phone number.

`PATCH /phoneNumbers/{phoneNumber}/capabilities`

## Path parameters

- `phoneNumber` string, required

## Query parameters

- `api-version` string, required

## Response `202`

The service has accepted the request and will start processing later. It will return 'Accepted' immediately and include an 'Operation-Location' and 'Location' headers. Client side should further query the operation status using the URL specified in 'Operation-Location' header. When operation completes successfully query final result using URL specified in 'Location' header.

- PurchasedPhoneNumber — Represents a purchased phone number.
  - `id` string, required — The id of the phone number, e.g. 11234567890.
  - `phoneNumber` string, required — String of the E.164 format of the phone number, e.g. +11234567890.
  - `countryCode` string, required — The ISO 3166-2 code of the phone number's country, e.g. US.
  - `phoneNumberType` 'geographic' | 'tollFree' | 'mobile', required — The phone number's type, e.g. geographic, tollFree, mobile.
  - `capabilities` PhoneNumberCapabilities, required — Capabilities of a phone number.
    - `calling` 'none' | 'inbound' | 'outbound' | 'inbound+outbound', required — Capability value for calling.
    - `sms` 'none' | 'inbound' | 'outbound' | 'inbound+outbound', required — Capability value for SMS.
  - `assignmentType` 'person' | 'application', required — The assignment type of the phone number. A phone number can be assigned to a person, or to an application.
  - `purchaseDate` string, date-time, required — The date and time that the phone number was purchased.
  - `cost` PhoneNumberCost, required — The incurred cost for a single phone number.
    - `amount` number, double, required — The cost amount.
    - `currencyCode` string, required — The ISO 4217 currency code for the cost amount, e.g. USD.
    - `billingFrequency` 'monthly', required — The frequency with which the cost gets billed.

## Other responses

- `default` — Failure

## Changes

- **2026-07-13** (2021-03-07) `1dbc8bc20279` — 1 info
  - api operation id `PhoneNumbers_UpdateCapabilitiesOC` removed and replaced with `PhoneNumbers_UpdateCapabilities`
- **2026-07-13** (2021-03-07) `1f405ce75e45` — 1 info
  - api operation id `PhoneNumbers_UpdateCapabilities` removed and replaced with `PhoneNumbers_UpdateCapabilitiesOC`

[Change history](https://skmtc.dev/azure/apis/communication-phonenumbers/changes/phoneNumbers/:phoneNumber/capabilities/patch.md)

---

[API](https://skmtc.dev/azure/apis/communication-phonenumbers.md) · [All operations](https://skmtc.dev/azure/apis/communication-phonenumbers/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/communication-phonenumbers/revisions/6e81b3741aa7/schema)