# Zoom Phone - August 22, 2022

<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->

## New

-   **Delete unassigned phone numbers** API

    -   `DELETE /v2/phone/numbers`

-   **Batch add users** API under **Users**

    -   `POST /v2/phone/users/batch`

## Enhancements

-   Added **Call waiting** support for **Update a call handling
    setting** API with new fields (`busy_on_another_call_action`, `busy_require_press_1_before_connecting`, `un_answered_require_press_1_before_connecting`, `overflow_play_callee_voicemail_greeting`, `play_callee_voicemail_greeting`, `busy_play_callee_voicemail_greeting`,`busy_phone_number`, `busy_description`, `busy_forward_to_extension_id`)

    -   `PATCH /v2/phone/extension/{extensionId}/call_handling/settings/{settingType}`

-   Changed rate limits from `Heavy` to `Medium` for **SMS** API

    -   `GET /v2/phone/sms/sessions`
    -   `GET /v2/phone/sms/sessions/{sessionId}`
    -   `GET /v2/phone/sms/sessions/{sessionId}/sync`
    -   `GET /v2/phone/users/{userId}/sms/sessions/sync`

-   New response field `unread_message_count` in **List user's SMS
    sessions in descending order** API

    -   `GET /v2/phone/users/{userId}/sms/sessions/sync`

-   New query parameters (`site_id`, `owner_type` and `voicemail_type`) in
    **Get account voicemails** API

    -   `GET /v2/phone/voice_mails`

-   New request parameters (`site_id`, `device_type`, `device_source` and `location_status`) in
    **List devices** API

    -   `GET /v2/phone/devices`

-   New request parameters (`site_id`, `cost_center`, `department`) in
    **List call queues** API

    -   `GET /v2/phone/call_queues`

-   New request parameters (`calling_type` and `status`) in **List phone
    users** API

    -   `GET /v2/phone/users`

-   New request/response object `desk_phone` in **Sites** API

    -   `GET /v2/phone/sites/{siteId}/settings/{settingType}`
    -   `PATCH /v2/phone/sites/{siteId}/settings/{settingType}`

-   New response fields (`policy.auto_call_recording_access_members` and `policy.adhoc_call_recording_access_members`)
    in **Get a user's profile** API:

    -   `GET /v2/phone/users/{userId}`

-   New response objects (`auto_call_recording_access_members` and `adhoc_call_recording_access_members`)
    in **Get a user's profile settings** API

    -   `GET /v2/phone/users/{userId}/settings`

-   New options (`auto_call_recording`, `ad_hoc_call_recording`) for
    the `settingType` path parameter and request objects (`auto_call_recording_access_members`, `adhoc_call_recording_access_members`)
    in **Add/ Update a user's shared access setting** API

    -   `POST /v2/phone/users/{userId}/settings/{settingType}`
    -   `PATCH /v2/phone/users/{userId}/settings/{settingType}`

-   New options (`auto_call_recording`, `ad_hoc_call_recording`) for
    the `settingType` path parameter in **Delete a user's shared access
    setting** API

    -   `DELETE /v2/phone/users/{userId}/settings/{settingType}`

-   **Phone Status** webhook events have `device_id` field added:

    -   `phone.callee_hold`
    -   `phone.callee_unhold`
    -   `phone.callee_mute`
    -   `phone.callee_unmute`
    -   `phone.callee_meeting_inviting`
    -   `phone.callee_parked`
    -   `phone.caller_ringing`
    -   `phone.caller_connected`
    -   `phone.caller_ended`
    -   `phone.caller_hold`
    -   `phone.caller_unhold`
    -   `phone.caller_mute`
    -   `phone.caller_unmute`
    -   `phone.caller_meeting_inviting`
    -   `phone.caller_parked`

## Bug Fixes

-   Fixed the query logic in **Get account voicemails** API

    -   `GET /v2/phone/voice_mails`

-   Fixed the error message notification issue when one of the SMS
    participants has been deleted in **Sync SMS by session ID** API

    -   `GET /v2/phone/sms/sessions/{sessionId}/sync`

-   Fixed the null value issue in the `call_log_id` field in the **Call recording is completed** webhook event

    -   `phone.recording_completed`

-   Fixed so the `audio_id` obtained by calling the **List audio items**
    API can now be used in the **Update the site setting** API to update
    the audio prompt of a site

    -   `PATCH /v2/phone/sites/{siteId}/settings/{settingType}`