Update a user's shared access setting
PATCH {{baseUrl}}/phone/users/:userId/settings/:settingType
Updates 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:update:shared_setting
,
phone:update:shared_setting:admin
Rate Limit Label
:
Light
Request Body
{"delegation"=>{"privacy"=>"<boolean>", "privileges"=>3, "locked"=>"<boolean>"}, "desk_phone"=>{"devices"=>[{"id"=>"<string>", "policy"=>{"call_control"=>{"status"=>"off"}, "hot_desking"=>{"status"=>"off"}}}, {"id"=>"<string>", "policy"=>{"call_control"=>{"status"=>"on"}, "hot_desking"=>{"status"=>"on"}}}], "phone_screen_lock"=>"<boolean>", "pin_code"=>"<string>"}, "voice_mail"=>{"access_user_id"=>"<string>", "delete"=>"<boolean>", "download"=>"<boolean>", "shared_id"=>"<string>"}, "intercom"=>{"extension_id"=>"<string>", "device_id"=>"<string>"}, "voicemail_access_members"=>[{"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>", "allow_sharing"=>"<boolean>", "shared_id"=>"<string>"}, {"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>", "allow_sharing"=>"<boolean>", "shared_id"=>"<string>"}], "auto_call_recording_access_members"=>[{"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>", "shared_id"=>"<string>"}, {"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>", "shared_id"=>"<string>"}], "ad_hoc_call_recording_access_members"=>[{"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>", "shared_id"=>"<string>"}, {"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>", "shared_id"=>"<string>"}]}
HEADERS
| Key | Datatype | Required | Description |
| Content-Type
| string | | |
RESPONSES
status: ``