Add a user's shared access setting
POST {{baseUrl}}/phone/users/:userId/settings/:settingType
Adds 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:write:shared_setting
,
phone:write:shared_setting:admin
Rate Limit Label
:
Light
Request Body
{"delegation_assistant_extension_id"=>"<string>", "device_id"=>"<string>", "voice_mail"=>{"access_user_id"=>"<string>", "delete"=>"<boolean>", "download"=>"<boolean>"}, "voicemail_access_members"=>[{"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>", "allow_sharing"=>"<boolean>"}, {"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>", "allow_sharing"=>"<boolean>"}], "auto_call_recording_access_members"=>[{"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>"}, {"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>"}], "ad_hoc_call_recording_access_members"=>[{"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>"}, {"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>"}]}
HEADERS
| Key | Datatype | Required | Description |
| Content-Type
| string | | |
| Accept
| string | | |
RESPONSES
status: Created
{"delegation":{"assistants":[{"display_name":"\u003cstring\u003e","extension_id":"\u003cstring\u003e","extension_number":"\u003clong\u003e","extension_type":"\u003cstring\u003e","id":"\u003cstring\u003e"},{"display_name":"\u003cstring\u003e","extension_id":"\u003cstring\u003e","extension_number":"\u003clong\u003e","extension_type":"\u003cstring\u003e","id":"\u003cstring\u003e"}],"privacy":"\u003cboolean\u003e","privileges":2},"voice_mail":{"access_user_id":"\u003cstring\u003e","delete":"\u003cboolean\u003e","download":"\u003cboolean\u003e","shared_id":"\u003cstring\u003e"},"voicemail_access_members":[{"access_user_id":"\u003cstring\u003e","allow_delete":"\u003cboolean\u003e","allow_download":"\u003cboolean\u003e","allow_sharing":"\u003cboolean\u003e","shared_id":"\u003cstring\u003e"},{"access_user_id":"\u003cstring\u003e","allow_delete":"\u003cboolean\u003e","allow_download":"\u003cboolean\u003e","allow_sharing":"\u003cboolean\u003e","shared_id":"\u003cstring\u003e"}],"auto_call_recording_access_members":[{"access_user_id":"\u003cstring\u003e","allow_delete":"\u003cboolean\u003e","allow_download":"\u003cboolean\u003e","shared_id":"\u003cstring\u003e"},{"access_user_id":"\u003cstring\u003e","allow_delete":"\u003cboolean\u003e","allow_download":"\u003cboolean\u003e","shared_id":"\u003cstring\u003e"}],"ad_hoc_call_recording_access_members":[{"access_user_id":"\u003cstring\u003e","allow_delete":"\u003cboolean\u003e","allow_download":"\u003cboolean\u003e","shared_id":"\u003cstring\u003e"},{"access_user_id":"\u003cstring\u003e","allow_delete":"\u003cboolean\u003e","allow_download":"\u003cboolean\u003e","shared_id":"\u003cstring\u003e"}]}