Skip to main content

Hi, when creating group with this Box API:





There are 3 options to choose from for member_viewability_level:





  • admins_only - the enterprise admin, co-admins, group’s group admin


  • admins_and_members - all admins and group members


  • all_managed_users - all managed users in the enterprise




Also in admin UI there is Permission Setting on group page with also 3 options, but they don’t match.



When creating group with API, this is how chosen options are reflected in UI:


admins_only → Admins only


admins_and_members → Admins only


all_managed_users → Company



But I can’t figure out they way to set Permission Setting to “Group members” no matter what options I pass through API, how can I do this?

Hi @Eugene



Welcome to the forum!



You’re absolutely right, we are using different language between the administration console and the API:



The admins console:




API Docs:


image



So the equivalence is:





  • admin_only → Admins Only


  • admins_and_members → Group Members


  • all_managed_users → Company




I’m not sure I understand your other question:





Assuming you’re referring to the user role within the group (admin or member) you can set that up when you manage the group users:







Let us know if this is what you were looking for.



Cheers


Hi @rbarbosa, thank you for your reply!



My question was about this:





So the equivalence is:





  • admin_only → Admins Only


  • admins_and_members → Group Members


  • all_managed_users → Company






The problem it that it was not what was happening there. When I create group with this params:



{

"name": "test23hlk0urasdlnalkj20m93",

"member_viewability_level": "admins_and_members"

}



Permission Setting in UI of the created group will still be “Admins Only”. Also at least in UI its gonna be same if we pass “admin_only” to “member_viewability_level”. So no matter what I pass to “member_viewability_level”, it never becomes “Group Members” in UI.



But I think I figured it out, “Permission Setting” of the created group only becomes “Group Members” when I set both “invitability_level” and “member_viewability_level” to “admins_and_members” with query like this:



{

"name": "test23hlk0urasdlnalkj20m93",

"invitability_level": "admins_and_members",

"member_viewability_level": "admins_and_members"

}



If one of “invitability_level” or “member_viewability_level” is missing in the query, group will be created with “Admins Only” permission setting.


I think I am fine with this as it solves the problem, but its quiet confusing as it never mentioned in docs (or I missed it somewhere) that Permission Setting depends both on “invitability_level” “member_viewability_level” in API.


Hi @Eugene



I completely missed your point, but I see it now.



And yes, it is missing from the documentation. It may be defaulting to admin_only and then forcing the other parameter.



We’ll investigate.



Thanks for spotting this.



Cheers


Reply