---
title: "Patch Extension"
method: PATCH
path: "/v4/accounts/{voip_id}/extensions/{extension_id}"
tags: ["Extensions"]
---

# Patch Extension

`PATCH /v4/accounts/{voip_id}/extensions/{extension_id}`

## Request

- Base URL: `https://api.phone.com`
- URL: `https://api.phone.com/v4/accounts/{voip_id}/extensions/{extension_id}`
- Auth: HTTP bearer

Replace parameters on an individual extension, only provided parameters will be replaced.

## Path parameters

- `voip_id` integer, required
- `extension_id` integer, required

## Request body

- Extension
  - `usage_type` 'limited' | 'unlimited': Can be 'limited' or 'unlimited'. In most cases, changing this will affect your monthly bill.
  - `extension` integer, nullable: Extension number that callers may dial. On POST, leaving this empty will result in an auto-generated value. On PUT, this field is required.
  - `full_name` string, nullable: Full name of the individual or department to which this extension is assigned
  - `name` string, nullable: User-supplied name for the extension. On POST, leaving this empty will result in an auto-generated value. On PUT, this field is required
  - `timezone` string, nullable: Time zone in IANA time zone database format (like 'America/Los_Angeles')
  - `name_greeting` object, nullable: Greeting that communicates the extension's name
    - `id` integer, nullable: Recording ID. Read-only
    - `name` string, nullable: Name of recording
  - `include_in_directory` boolean, nullable: Whether this extension should be included in the dial-by-name directory for this account.
  - `caller_id` string, nullable: Phone number to use as Caller ID for outgoing calls. Must be a phone number belonging to this account, or one of any additional authorized phone number
  - `local_area_code` integer, nullable: For outbound calls, this is the North American area code that this extension is calling from
  - `enable_call_waiting` boolean, nullable: Whether Call Waiting is enabled. Default is TRUE
  - `enable_outbound_calls` boolean, nullable: Whether outgoing calls are enabled. Default is TRUE.
  - `bypass_hard_phone` boolean, nullable: Set 'true' if you want to use advanced call handling rules instead of device
  - `voicemail` object: Voicemail Object.
    - `enabled` boolean, nullable: Whether voicemail is enabled
    - `password` string, nullable: Password for accessing voicemail box. Must be digits only.
    - `greeting` object: Voicemail Greeting Object
      - `type` 'name' | 'standard' | 'alternate': The greeting to play. Can be 'name' for the name_greeting as described above, 'standard' for the standard greeting, or 'alternate' for an alternate greeting.
      - `standard` object, nullable: Greeting to be played when type='standard'
        - `id` integer, nullable: Recording ID. Read-only.
        - `name` string, nullable: Name of recording
      - `alternate` object, nullable: Greeting to be played when type='alternate'
        - `id` integer, nullable: Recording ID. Read-only.
        - `name` string, nullable: Name of recording
      - `enable_leave_message_prompt` boolean, nullable: Whether to prompt the caller with the following words after the voicemail greeting has been played: 'Please leave your message after the tone. When finished, hang up or press the pound key.
    - `transcription` 'human' | 'automated': Type of voicemail transcription to use. Can be 'human' for high-quality manual transcriptions by human operators, 'automated' for machine-generated transcriptions, or NULL to omit trancriptions
    - `attachments` 'wav' | 'mp3': If notification emails are being used, this defines the format of the audio attachments. Can be 'wav' for WAV format, 'mp3' for MP3 format, or NULL to disable attachments.
    - `notifications` object: Voicemail Notifications Object. Can be set to NULL to disable notifications.
      - `emails` string, nullable: Array of email addresses
      - `sms` string, nullable: Phone number capable of receiving SMS messages
  - `call_notifications` object, nullable: Call Notifications Object
    - `emails` string, nullable: Array of email addresses
    - `sms` string, nullable: Phone number capable of receiving SMS messages
  - `presence_publish` boolean, nullable
  - `presence_subscribe` boolean, nullable
  - `route` unknown

## Response `200`

OK

- object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation failed
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com.md) · [All operations](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/llms.txt) · [OpenAPI document](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/revisions/70c6c9ab8d8f?raw)