Logo
Zoom Public API Documentation

Delete a user's shared access setting

DELETE {{baseUrl}}/phone/users/:userId/settings/:settingType?shared_id=<string>&assistant_extension_id=<string>&device_id=<string>&intercom_extension_id=<string>

Removes the user setting according to the setting type, specifically for delegation, intercom and shared access for voicemail and call recordings. For user-level apps, pass the me value instead of the userId parameter.

To see the shared access settings in the Zoom web portal, go to Admin > Phone System Management > Users & Rooms . Click Users and select User Policy. Go to Voicemail, Automatic Call Recording and Ad Hoc Call Recording.

To view the delegation and intercom setting in your Zoom web portal, navigate to Admin > Phone System Management > Users & Rooms. Click the Users tab and select User Settings

Prerequisites: * A Business or Enterprise account

Scopes: phone:write:admin,phone:write

Granular Scopes: phone:delete:shared_setting,phone:delete:shared_setting:admin

Rate Limit Label: Light

 

Body PARAM

Key Datatype Required Description 
shared_id
string This field is required only for voicemail, auto_call_recording, and ad_hoc_call_recording setting type.
assistant_extension_id
string This field deletes the delegation assistant, used for delegation setting type.
device_id
string This field deletes the assigned device, used for `desk_phone` setting type.
intercom_extension_id
string This field deletes the intercom connection for the `intercom` setting type.



HEADERS

Key Datatype Required Description 




RESPONSES

status





Curl
curl -X DELETE 'https://api.zoom.us/v2/phone/users/:userId/settings/:settingType?shared_id=<string>&assistant_extension_id=<string>&device_id=<string>&intercom_extension_id=<string>?shared_id=<string>&assistant_extension_id=<string>&device_id=<string>&intercom_extension_id=<string>'

ENDPOINTS