# Phone Update User Shared Access Settings fails for some privilege values

**URL:** <https://devforum.zoom.us/t/phone-update-user-shared-access-settings-fails-for-some-privilege-values/127590>\
**Category:** API and Webhooks\
**Tags:** phone\
**Created:** [February 19, 2025, 9:53pm UTC](https://devforum.zoom.us/t/phone-update-user-shared-access-settings-fails-for-some-privilege-values/127590 "2025-02-19T21:53:19Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![kris.seraphine](https://avatars.discourse-cdn.com/v4/letter/k/dc4da7/32.png) [@kris.seraphine](https://devforum.zoom.us/u/kris.seraphine)\
**Post date:** [February 19, 2025, 9:53pm UTC](https://devforum.zoom.us/t/phone-update-user-shared-access-settings-fails-for-some-privilege-values/127590/1 "2025-02-19T21:53:19Z")

</div>

I’m attempting to use the Zoom Phone API to update delegation privileges for phone users. The relevant API endpoint is `https://developers.zoom.us/docs/api/phone/#tag/users/PATCH/phone/users/{userId}/settings/{settingType})`.

They privileges are represented as an array of integers in the payload. It appears the API only supports a subset of the privileges that can be set in the web UI.

For example, if I configure the privileges through the web UI and use then send a GET to ``/v2/phone/users/[userid]/settings/delegation`, the delegation privileges for a user in the response are:

```json
{"delegation": {"privileges": [1, 2, 5]}}

```

If I send a PATCH to `/v2/phone/users/[userid]/settings/delegation` with the same values in the payload, I get a 400 “Delegation privileges error.” response.

However, if I limit privilege values to 1, 2, 3, my updates are successful. It appears the API only supports these values. Based on comparing GET responses to the Web UI configuration, the complete enum list is:

```
1: Place Calls
2: Answer Calls
3: Pick Up Hold Calls
4: Set Business Hours
5: Opt In/Out
6: Join and Merge Calls

```

Can someone confirm for me that this is an API limitation and if so, an estimate on when it may be addressed?

Please let me know if any additional information is needed.

---

<div class="post-metadata">

**Author:** ![elisa.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/elisa.zoom/32/47836_2.png) [@elisa.zoom](https://devforum.zoom.us/u/elisa.zoom)\
**Post date:** [February 21, 2025, 2:31pm UTC](https://devforum.zoom.us/t/phone-update-user-shared-access-settings-fails-for-some-privilege-values/127590/2 "2025-02-21T14:31:15Z")

</div>

Hi @kris.seraphine  
Thanks for reaching out to us and sharing all this information! I will take a closer look to this and do some testing on my end and I will report back to you  
Thanks  
Elisa

---

<div class="post-metadata">

**Author:** ![elisa.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/elisa.zoom/32/47836_2.png) [@elisa.zoom](https://devforum.zoom.us/u/elisa.zoom)\
**Post date:** [February 24, 2025, 7:38pm UTC](https://devforum.zoom.us/t/phone-update-user-shared-access-settings-fails-for-some-privilege-values/127590/3 "2025-02-24T19:38:30Z")

</div>

Hey there! I am trying to replicate this on my end and you mentioned you are making a request to GET to ``/v2/phone/users/[userid]/settings/delegation`, but I do not think this endpoint is available. could you clarify this for me please

---

<div class="post-metadata">

**Author:** ![kris.seraphine](https://avatars.discourse-cdn.com/v4/letter/k/dc4da7/32.png) [@kris.seraphine](https://devforum.zoom.us/u/kris.seraphine)\
**Post date:** [February 24, 2025, 8:34pm UTC](https://devforum.zoom.us/t/phone-update-user-shared-access-settings-fails-for-some-privilege-values/127590/4 "2025-02-24T20:34:36Z")

</div>

My bad. The GET endpoint is actually `/phone/users/{userId}/settings` with the relevant values in the `delegation` object in the response.

This is the “get a user’s profile settings” endpoint documented here:

> **[Phone APIs - Zoom Developers](https://developers.zoom.us/docs/api/phone/#tag/users/GET/phone/users/%7BuserId%7D/settings)**
>
> API reference for: Phone

---

<div class="post-metadata">

**Author:** ![elisa.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/elisa.zoom/32/47836_2.png) [@elisa.zoom](https://devforum.zoom.us/u/elisa.zoom)\
**Post date:** [March 1, 2025, 1:32am UTC](https://devforum.zoom.us/t/phone-update-user-shared-access-settings-fails-for-some-privilege-values/127590/5 "2025-03-01T01:32:57Z")

</div>

Thanks, @kris.seraphine. I was able to replicate this issue on my end. It appears that there is a note in the UI for some of these privileges (visible when you hover over the question mark), which might explain why you can’t update them via the API. I’ve reached out to our Engineering team to learn more and will update you as soon as I hear back (internal ticket: ZSEE-159439).

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/3X/6/1/614bdd549b610bbaa46ff934617683a02bdaa03c.png) [@system](https://devforum.zoom.us/u/system)\
**Post date:** [March 4, 2026, 5:09pm UTC](https://devforum.zoom.us/t/phone-update-user-shared-access-settings-fails-for-some-privilege-values/127590/6 "2026-03-04T17:09:19Z")

</div>

Closed on March 4, 2026, 5:09pm UTC

This topic was automatically closed 368 days after the last reply. New replies are no longer allowed.
